az dt data-history connection create

Note

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie eine az dt-Datenverlaufsverbindung zum ersten Mal ausführen, Befehl erstellen. Erfahren Sie mehr über Erweiterungen.

Erstellt eine Datenhistorienverbindung zwischen einer Digital Twins-Instanz und unterstützten Ressourcen.

Befehle

Name	Beschreibung	Typ	Status
az dt data-history connection create adx	Erstellt eine Datenverlaufsverbindung zwischen einer Digital Twins-Instanz und einer Azure Data Explorer-Datenbank. Erfordert vorab erstellte Azure Data Explorer- und Event Hub-Ressourcen.	Extension	GA

az dt data-history connection create adx

Erstellt eine Datenverlaufsverbindung zwischen einer Digital Twins-Instanz und einer Azure Data Explorer-Datenbank. Erfordert vorab erstellte Azure Data Explorer- und Event Hub-Ressourcen.

Fordert den Benutzer auf, die folgenden Rollen und Berechtigungen für die Digital Twins-Instanz oder die vom Benutzer zugewiesene Identität hinzuzufügen, die zum erfolgreichen Erstellen der Verbindung erforderlich ist:

Rolle "Mitwirkender" für den Azure Data Explorer-Datenbankbereich
Berechtigung "Datenbankadministrator" für den Azure Data Explorer-Datenbankbereich
Rolle "Azure Event Hubs Data Owner" für den Event Hub-Bereich.

az dt data-history connection create adx --adx-cluster-name --adxc
                                         --adx-database-name --adxd
                                         --cn --conn-name
                                         --dt-name --dtn
                                         --eh --eventhub
                                         --ehn --eventhub-namespace
                                         [--adx-property-events-table --adxpet]
                                         [--adx-record-removals --adxrr {false, true}]
                                         [--adx-relationship-events-table --adxret]
                                         [--adx-resource-group --adxg]
                                         [--adx-subscription --adxs]
                                         [--adx-table-name --adxt]
                                         [--adx-twin-events-table --adxtet]
                                         [--ehc --eventhub-consumer-group]
                                         [--ehg --eventhub-resource-group]
                                         [--ehs --eventhub-subscription]
                                         [--mi-user-assigned --user]
                                         [--no-wait]
                                         [--resource-group]
                                         [--yes]

Beispiele

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit der $Default Event Hub-Consumergruppe hinzu.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz hinzu, wobei eine dem Digital Twin zugeordnete Benutzeridentität mit der $Default Event Hub-Consumergruppe verknüpft ist.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --mi-user-assigned {resource_id}

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit einem benutzerdefinierten Azure Data Explorer-Tabellennamen und einer Event Hub-Consumergruppe hinzu.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-property-events-table {adx_property_events_table_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-consumer-group {event_hub_consumer_group}

Fügt eine Datenverlaufsverbindung zu einer Ziel-Digital Twins-Instanz hinzu, die in eine Event Hub- und Azure Data Explorer-Instanz in verschiedenen Ressourcengruppen und Abonnements von der Zielinstanz integriert wird.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-resource-group {adx_resource_group} --adx-subscription {adx_subscription} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-resource-group {event_hub_resource_group} --eventhub-subscription {event_subscription}

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit der $Default Event Hub-Consumergruppe hinzu und überspringt die Rollenzuweisungsaufforderungen.

az dt data-history connection create adx -n {instance_name} -y --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit der $Default Event Hub-Consumergruppe hinzu und ermöglicht das Entfernen von Datensatzeigenschaften und Elementen. Eine zusätzliche Spalte wird der Tabelle hinzugefügt, die zum Speichern von Aktualisierungen von Eigenschaften von Zwillingen und Beziehungen verwendet wird (standardmäßig adtPropertyEvents).

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-record-removals true

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit der $Default Event Hub-Consumergruppe hinzu und erstellt zwei zusätzliche Tabellen in der Azure Data Explorer-Datenbank. Eine Tabelle wird zum Aufzeichnen von Twin-Lifecycle-Ereignissen und zum anderen für Beziehungslebenszyklusereignisse verwendet.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

Fügt eine Datenverlaufsverbindung zu einer Digital Twins-Zielinstanz mit der Consumergruppe $Default Event Hub hinzu, verwendet einen benutzerdefinierten Namen der Ereignistabelle für twin-Eigenschaften und erstellt zwei zusätzliche Tabellen in der Azure Data Explorer-Datenbank.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-property-events-table {adx_property_events_table_name} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

Erforderliche Parameter

--adx-cluster-name --adxc

Name des Azure Data Explorer-Clusters für die Integration.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--adx-database-name --adxd

Name der Azure Data Explorer-Datenbank für die Integration.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--cn --conn-name

Name der Datenverlaufsverbindung.

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--eh --eventhub

Name von EventHub zur Integration in.

Eigenschaft	Wert
Parametergruppe:	Event Hub Arguments

--ehn --eventhub-namespace

EventHub-Namespacebezeichner.

Eigenschaft	Wert
Parametergruppe:	Event Hub Arguments

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--adx-property-events-table --adxpet

Der Name der Azure Data Explorer-Tabelle, die zum Speichern von Updates für Eigenschaften von Zwillingen und Beziehungen verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments
Standardwert:	AdtPropertyEvents

--adx-record-removals --adxrr

Gibt an, ob Twin/Relationship-Eigenschaft und Elemententfernungen erfasst werden sollen, einschließlich Entfernungen von indizierten oder schlüsselierten Werten (z. B. Karteneinträge, Arrayelemente usw.). Wenn Sie diese Eigenschaft auf "true" festlegen, wird eine zusätzliche Spalte in der Eigenschaftsereignissetabelle in ADX generiert.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments
Standardwert:	False
Zulässige Werte:	false, true

--adx-relationship-events-table --adxret

Der Name der Azure Data Explorer-Tabelle, die zum Aufzeichnen von Beziehungslebenszyklusereignissen verwendet wird. Die Tabelle wird nicht erstellt, wenn diese Eigenschaft nicht angegeben ist.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--adx-resource-group --adxg

Name der Azure Data Explorer-Ressourcengruppe. Wenn nicht angegeben, wird die Ressourcengruppe von Digital Twin verwendet.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--adx-subscription --adxs

Name oder ID des Abonnements, in dem der Azure-Daten-Explorer vorhanden ist. Wenn nicht angegeben, verwenden Sie das Abonnement, das die Digital Twin-Instanz enthält.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--adx-table-name --adxt

Als veraltet markiert

Option "--adx-table-name" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--adx-property-events-table".

Der Name der Azure Data Explorer-Tabelle, die zum Speichern von Updates für Eigenschaften von Zwillingen und Beziehungen verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments
Standardwert:	AdtPropertyEvents

--adx-twin-events-table --adxtet

Der Name der Azure Data Explorer-Tabelle, die zum Aufzeichnen von Twin-Lifecycle-Ereignissen verwendet wird. Die Tabelle wird nicht erstellt, wenn diese Eigenschaft nicht angegeben ist.

Eigenschaft	Wert
Parametergruppe:	Azure Data Explorer Arguments

--ehc --eventhub-consumer-group

Die EventHub-Consumergruppe, die verwendet werden soll, wenn ADX aus EventHub liest.

Eigenschaft	Wert
Parametergruppe:	Event Hub Arguments
Standardwert:	$Default

--ehg --eventhub-resource-group

Name der EventHub-Ressourcengruppe. Wenn nicht angegeben, wird die Ressourcengruppe von Digital Twin verwendet.

Eigenschaft	Wert
Parametergruppe:	Event Hub Arguments

--ehs --eventhub-subscription

Name oder ID des Abonnements, in dem der EventHub vorhanden ist. Wenn nicht angegeben, verwenden Sie das Abonnement, das die Digital Twin-Instanz enthält.

Eigenschaft	Wert
Parametergruppe:	Event Hub Arguments

--mi-user-assigned --user

Verwenden Sie eine vom Benutzer zugewiesene verwaltete Identität für die Datenverlaufsverbindungsauthentifizierung. Akzeptiert die Identitätsressourcen-ID. Wenn nicht angegeben, wird stattdessen die Systemidentität verwendet.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft	Wert
Standardwert:	False

--resource-group -g

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

--yes -y

Fordern Sie beim Zuweisen der erforderlichen Rollen keine Bestätigung auf.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?