az dt job import

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). 擴充功能會在您第一次執行 az dt job import 命令時自動安裝。 Learn more about extensions.

管理和設定作業，以便將模型、對應項和關聯性數據匯入至數位對應項實例。

命令

名稱	Description	類型	狀態
az dt job import cancel	取消在數字對應項實例上執行的數據匯入作業。	Extension	GA
az dt job import create	在數字對應項實例上建立和執行數據匯入作業。	Extension	GA
az dt job import delete	刪除在數字對應項實例上執行的數據匯入作業。	Extension	GA
az dt job import list	列出在數字對應項實例上執行的所有數據匯入作業。	Extension	GA
az dt job import show	顯示在數字對應項實例上執行的數據匯入作業詳細數據。	Extension	GA

az dt job import cancel

取消在數字對應項實例上執行的數據匯入作業。

az dt job import cancel --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

範例

依作業標識碼取消數據匯入作業。

az dt job import cancel -n {instance_or_hostname} -j {job_id}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

--job-id -j

作業的標識碼。 在建立作業期間省略此參數時，會指派系統產生的標識碼。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt job import create

在數字對應項實例上建立和執行數據匯入作業。

命令需要輸入匯入數據檔（以 .ndjson 格式）出現在輸入 Blob 容器中。 此外，所使用的 DT 實例必須在輸入記憶體帳戶上設定 「記憶體 Blob 數據參與者」角色。 作業完成之後，將會建立包含作業記錄和錯誤的輸出檔案。

az dt job import create --data-file --df
                        --dt-name --dtn
                        --ibc --input-blob-container
                        --input-storage-account --isa
                        [--job-id]
                        [--obc --output-blob-container]
                        [--of --output-file]
                        [--osa --output-storage-account]
                        [--resource-group]

範例

建立作業以匯入儲存在 Azure 記憶體容器中的數據檔。 匯入作業的輸出檔案會在輸入檔的 Blob 容器中建立。

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name}

建立作業以匯入儲存在 Azure 記憶體容器中的數據檔。 匯入作業的輸出檔案是在使用者定義的記憶體帳戶和 Blob 容器中建立的。

az dt job import create -n {instance_or_hostname} --data-file {data_file_name} --input-blob-container {input_blob_container_name} --input-storage-account {input_storage_account_name} --output-file {output_file_name} --output-blob-container {output_blob_container_name} --output-storage-account {output_storage_account_name}

必要參數

--data-file --df

大容量導入作業的數據檔輸入名稱。 檔案必須是 『ndjson』 格式。 範例輸入資料檔：https://github.com/Azure/azure-iot-cli-extension/tree/dev/docs/samples/adt-bulk-import-data-sample.ndjson。

屬性	值
Parameter group:	Bulk Import Job Arguments

--dt-name --dtn -n

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

--ibc --input-blob-container

包含大容量導入數據檔的 Azure 記憶體 Blob 容器名稱。

屬性	值
Parameter group:	Bulk Import Job Arguments

--input-storage-account --isa

Azure 記憶體帳戶的名稱，其中包含儲存大容量導入數據檔的 Blob 容器。

屬性	值
Parameter group:	Bulk Import Job Arguments

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--job-id -j

作業的標識碼。 在建立作業期間省略此參數時，會指派系統產生的標識碼。

--obc --output-blob-container

將建立大容量導入作業輸出檔的 Azure 記憶體 Blob 容器名稱。 如果未提供，則會使用輸入 Blob 容器。

屬性	值
Parameter group:	Bulk Import Job Arguments

--of --output-file

大容量導入作業輸出檔的名稱。 此檔案會包含記錄檔和錯誤資訊。 一旦作業完成，檔案就會自動建立。 如果檔案已經存在，就會被覆寫。 如果未提供輸出檔案，則會以名稱建立：{job_id}_output.txt。

屬性	值
Parameter group:	Bulk Import Job Arguments

--osa --output-storage-account

Azure 記憶體帳戶的名稱，其中包含將建立大容量導入作業輸出檔的 Blob 容器。 如果未提供，則會使用輸入記憶體帳戶。

屬性	值
Parameter group:	Bulk Import Job Arguments

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt job import delete

刪除在數字對應項實例上執行的數據匯入作業。

az dt job import delete --dt-name --dtn
                        --job-id
                        [--resource-group]
                        [--yes]

範例

依作業標識碼刪除資料匯入作業。

az dt job import delete -n {instance_or_hostname} -j {job_id}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

--job-id -j

作業的標識碼。 在建立作業期間省略此參數時，會指派系統產生的標識碼。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt job import list

列出在數字對應項實例上執行的所有數據匯入作業。

az dt job import list --dt-name --dtn
                      [--resource-group]

範例

列出目標數字對應項實例上的所有數據匯入作業。

az dt job import list -n {instance_or_hostname}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt job import show

顯示在數字對應項實例上執行的數據匯入作業詳細數據。

az dt job import show --dt-name --dtn
                      --job-id
                      [--resource-group]

範例

依作業標識碼顯示數據匯入作業的詳細數據。

az dt job import show -n {instance_or_hostname} -j {job_id}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱或主機名。 如果提供實例名稱，則會先查詢使用者訂用帳戶，讓目標實例擷取主機名。 如果提供主機名，則會略過訂用帳戶查詢，並提供的值會用於後續的互動。

--job-id -j

作業的標識碼。 在建立作業期間省略此參數時，會指派系統產生的標識碼。

選擇性參數

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

Output format.

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False