az dt job import

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az dt-Auftragsimportbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten und Konfigurieren von Aufträgen zum Importieren von Modell-, Twin- und Beziehungensdaten in eine digitale Zwillingsinstanz.

Befehle

Name Beschreibung Typ Status
az dt job import cancel

Abbrechen eines Datenimportauftrags, der auf einer digitalen Twins-Instanz ausgeführt wird.

 Durchwahl Allgemein verfügbar
az dt job import create

Erstellen und Ausführen eines Datenimportauftrags auf einer digitalen Twin-Instanz.

 Durchwahl Allgemein verfügbar
az dt job import delete

Löschen eines Datenimportauftrags, der auf einer digitalen Twins-Instanz ausgeführt wird.

 Durchwahl Allgemein verfügbar
az dt job import list

Auflisten aller Datenimportaufträge, die auf einer digitalen Twins-Instanz ausgeführt werden.

 Durchwahl Allgemein verfügbar
az dt job import show

Zeigen Sie Details eines Datenimportauftrags an, der auf einer digitalen Twins-Instanz ausgeführt wird.

 Durchwahl Allgemein verfügbar

az dt job import cancel

Abbrechen eines Datenimportauftrags, der auf einer digitalen Twins-Instanz ausgeführt wird.

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

Beispiele

Abbrechen eines Datenimportauftrags nach Auftrags-ID.

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

Erforderliche Parameter

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--job-id -j

Id des Auftrags. Eine vom System generierte ID wird zugewiesen, wenn dieser Parameter während der Auftragserstellung weggelassen wird.

Optionale Parameter

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az dt job import create

Erstellen und Ausführen eines Datenimportauftrags auf einer digitalen Twin-Instanz.

Der Befehl erfordert, dass eine Eingabeimportdatendatei (im ndjson-Format) im Eingabe-BLOB-Container vorhanden ist. Darüber hinaus muss für die verwendete DT-Instanz die Rolle "Storage Blob Data Contributor" für das Eingabespeicherkonto festgelegt sein. Nach Abschluss des Auftrags wird eine Ausgabedatei mit den Protokollen und Fehlern des Auftrags erstellt.

az dt job import create --data-file
                        --dt-name
                        --ibc
                        --input-storage-account
                        [--job-id]
                        [--obc]
                        [--of]
                        [--osa]
                        [--resource-group]

Beispiele

Erstellt einen Auftrag zum Importieren von Datendateien, die in einem Azure Storage-Container gespeichert sind. Die Ausgabedatei des Importauftrags wird im BLOB-Container der Eingabedatei erstellt.

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}

Erstellt einen Auftrag zum Importieren von Datendateien, die in einem Azure-Speichercontainer gespeichert sind. Die Ausgabedatei des Importauftrags wird im benutzerdefinierten Speicherkonto und blob-Container erstellt.

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}

Erforderliche Parameter

--data-file --df

Name der Datendateieingabe für den Massenimportauftrag. Die Datei muss im Format "ndjson" vorliegen. Beispieldatei für Eingabedaten: https://github.com/Azure/azure-iot-cli-extension/tree/dev/docs/samples/adt-bulk-import-data-sample.ndjson.

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--ibc --input-blob-container

Name des Azure Storage-BLOB-Containers, der die Massenimportdatendatei enthält.

--input-storage-account --isa

Name des Azure Storage-Kontos, das BLOB-Container enthält, in dem die Massenimportdatendatei gespeichert wird.

Optionale Parameter

--job-id -j

Id des Auftrags. Eine vom System generierte ID wird zugewiesen, wenn dieser Parameter während der Auftragserstellung weggelassen wird.

--obc --output-blob-container

Name des Azure Storage-BLOB-Containers, in dem die Ausgabedatei des Massenimportauftrags erstellt wird. Wenn nicht angegeben, wird der Eingabe-BLOB-Container verwendet.

--of --output-file

Name der Ausgabedatei des Massenimportauftrags. Diese Datei enthält Protokolle sowie Fehlerinformationen. Die Datei wird automatisch erstellt, sobald der Auftrag abgeschlossen ist. Die Datei wird überschrieben, wenn sie bereits vorhanden ist. Wenn die Ausgabedatei nicht mit dem Namen erstellt wird: <job_id>_output.txt.

--osa --output-storage-account

Name des Azure Storage-Kontos, das BLOB-Container enthält, in dem die Ausgabedatei des Massenimportauftrags erstellt wird. Wenn nicht angegeben, wird das Eingabespeicherkonto verwendet.

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az dt job import delete

Löschen eines Datenimportauftrags, der auf einer digitalen Twins-Instanz ausgeführt wird.

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

Beispiele

Löschen Eines Datenimportauftrags nach Auftrags-ID.

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

Erforderliche Parameter

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--job-id -j

Id des Auftrags. Eine vom System generierte ID wird zugewiesen, wenn dieser Parameter während der Auftragserstellung weggelassen wird.

Optionale Parameter

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az dt job import list

Auflisten aller Datenimportaufträge, die auf einer digitalen Twins-Instanz ausgeführt werden.

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

Beispiele

Auflisten aller Datenimportaufträge in einer Zielinstanz für digitale Zwillinge.

az dt job import list -n {instance_or_hostname}

Erforderliche Parameter

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

Optionale Parameter

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az dt job import show

Zeigen Sie Details eines Datenimportauftrags an, der auf einer digitalen Twins-Instanz ausgeführt wird.

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

Beispiele

Details eines Datenimportauftrags nach Auftrags-ID anzeigen.

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

Erforderliche Parameter

--dt-name --dtn -n

Name oder Hostname der Digital Twins-Instanz. Wenn ein Instanzname angegeben wird, wird das Benutzerabonnement zuerst für die Zielinstanz abgefragt, um den Hostnamen abzurufen. Wenn ein Hostname angegeben wird, wird die Abonnementabfrage übersprungen und der bereitgestellte Wert für nachfolgende Interaktionen verwendet.

--job-id -j

Id des Auftrags. Eine vom System generierte ID wird zugewiesen, wenn dieser Parameter während der Auftragserstellung weggelassen wird.

Optionale Parameter

--resource-group -g

Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.