az dt job import

參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分（2.46.0 版或更高版本）。擴充功能會在您第一次執行 az dt job import 命令時自動安裝。深入了解擴充功能。

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

命令

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

az dt job import cancel

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

az dt job import cancel --dt-name
                        --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

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

選擇性參數

--resource-group -g

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

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az dt job import create

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

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

az dt job import create --data-file
                        --dt-name
                        --ibc
                        --input-storage-account
                        [--job-id]
                        [--obc]
                        [--of]
                        [--osa]
                        [--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。

--dt-name --dtn -n

--ibc --input-blob-container

包含大容量導入數據檔的 blob 容器 Azure 儲存體名稱。

--input-storage-account --isa

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

選擇性參數

--job-id -j

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

--obc --output-blob-container

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

--of --output-file

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

--osa --output-storage-account

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

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az dt job import delete

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

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

範例

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

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

必要參數

--dt-name --dtn -n

--job-id -j

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

選擇性參數

--resource-group -g

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

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az dt job import list

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

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

範例

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

az dt job import list -n {instance_or_hostname}

必要參數

--dt-name --dtn -n

選擇性參數

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az dt job import show

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

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

範例

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

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

必要參數

--dt-name --dtn -n

--job-id -j

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

選擇性參數

--resource-group -g

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

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az dt job import

命令

az dt job import cancel

範例

必要參數

選擇性參數

az dt job import create

範例

必要參數

選擇性參數

az dt job import delete

範例

必要參數

選擇性參數

az dt job import list

範例

必要參數

選擇性參數

az dt job import show

範例

必要參數

選擇性參數

其他資源