IDAX.IMPORT_MODEL - 匯入模型

授權

任何有權建立新分析模型的使用者都可以從匯出檔匯入模型；不過，如果要改寫模型，您必須具有捨棄現有模型的權限。

語法

IDAX.IMPORT_MODEL(in parameter_string varchar(32672))

參數說明

parameter_string

必要的單一字串參數，其中包含以逗點區隔的 <parameter>=<value> 項目配對。

資料類型：VARCHAR(32672)

下列清單顯示參數值：

directory

必要。

包含要匯入之 .mdl 檔案之目錄的絕對路徑。

此目錄必須已存在.

name

必要。

您要匯入的 .mdl 檔案的名稱。

acl

選用。

指定是否要匯入模型專用權（存取控制清單）。

如果您將 acl 參數設為 true，但匯出作業中未包含模型專用權，則會傳回警告。

如果所匯入的存取控制清單指定的角色不存在於資料庫中，則會傳回警告。

預設值：false

log

選用。

指定是否要寫入日誌檔（使用 .ilog 副檔名）。 此日誌檔包含成功匯入的模型清單，以及匯入作業跳過之所有已跳過模型的名稱及隨附的錯誤訊息。

預設值：false

model

選用。

要匯入的模型或模型的綱目完整名稱。

使用分號來區隔多個模型名稱。如果有任何模型名稱使用大小寫混合格式，您必須以雙引號括住它們。

overwrite

選用。

發生名稱衝突時要採取的動作。

如果現有模型的名稱與您嘗試匯入的模型名稱相同，依預設，匯入作業會跳過該檔案。如果您指定 overwrite=true，則會先刪除現有模型，然後再將匯入新模型。

預設值：false

owner

選用。

IMPORT_MODEL 程序的現行呼叫所匯入之所有模型的替代擁有者。依預設，執行匯入作業的使用者就是所匯入模型的擁有者。

如果您要確保在匯入所匯出的模型之後仍保留其原始所有權，請指定 owner=owner。

resume

選用。

指定 IMPORT_MODEL 程序無法匯入模型時是否要停止。

依預設，會跳過無法匯入的任何模型，且匯入作業會繼續。

預設值：true

schemamap

選用。

所匯入模型的綱目轉換規則，使用以分號區隔的對映清單。

當那些模型匯入至資料庫時，請利用這個參數，將匯出的模型檔中的舊綱目名稱取代為新的綱目名稱。當新資料庫與從中匯出模型的資料庫沒有相同的綱目名稱，或者您要將某些模型傳送至不同的綱目時，您可以使用此參數。

指定 schemamap 參數，如下所示：

schemamap=mapping1;mapping2;mappingN

對映是以下列方式定義：

• <old_schema1>:<new_schema1>;<old_schema2>:<new_schema2>;<old_schemaN>:<new_schemaN>

  表示所匯入模型的綱目 <old_schema> 要變更為 <new_schema>。

• *:<new_schema>

  表示每個沒有對映規則的已匯入綱目都變更為 <new_schema>。

• <old_schema1>;<old_schema2>;<old_schemaN>

  表示所匯入模型的綱目 <old_schema> 要變更為現行綱目。

其中

選用。

過濾要匯入之模型的子句。

您可以利用 WHERE 子句來過濾 LIST_MODELS 程序所顯示的任何模型。

傳回的資訊

IMPORT_MODEL 程序傳回的結果集含有綱目（如果有 schemamap 參數指定的轉換，則為原始綱目和新綱目的名稱）及所有順利匯入之模型的名稱。如果 resume 參數設為 true，則結果集也包括所有跳過之模型的名稱和隨附的錯誤訊息。

範例

• 下列範例是從 /tmp/foo.mdl 匯入所有模型。不執行綱目轉換。

  call idax.import_model('directory=/tmp, name=foo')

• 下列範例是從 /tmp/foo.mdl 匯入所有模型。會將綱目為 "peter" 的模型匯入至綱目 "frank"，並將綱目為 "eva" 的模型匯入至綱目 "alice"。所有其他綱目維持不變。

  call idax.import_model('directory=/tmp, name=foo,
                          schemamap=peter:frank;eva:alice')

• 下列範例是從 /tmp/foo.mdl 匯入所有模型。會將綱目為 "peter" 的模型匯入至綱目 "frank"，並將所有其他模型匯入至綱目 "alice"。

  
  call idax.import_model('directory=/tmp, name=foo,
                          schemamap=peter:frank;*:alice')

• 下列範例是從 /tmp/foo.mdl 匯入所有模型。會將綱目為 "peter" 的模型匯入至現行綱目，並將所有其他模型匯入至綱目 "alice"。

  
  call idax.import_model('directory=/tmp, name=foo,
                          schemamap=peter;*:alice')

• 下列範例是從 /tmp/foo.mdl 匯入所有模型。所有模型會匯入至現行綱目。

  call idax.import_model('directory=/tmp, name=foo,
                          schemamap=*')