Freigeben über


az dt data-history connection create

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az dt-Datenverlauf-Verbindungserstellungsbefehl zum ersten Mal ausführen. Weitere Informationen zu 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.

Erweiterung Allgemein verfügbar

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
                                         --adx-database-name
                                         --cn
                                         --dt-name
                                         --eh
                                         --ehn
                                         [--adx-property-events-table]
                                         [--adx-record-removals {false, true}]
                                         [--adx-relationship-events-table]
                                         [--adx-resource-group]
                                         [--adx-subscription]
                                         [--adx-table-name]
                                         [--adx-twin-events-table]
                                         [--ehc]
                                         [--ehg]
                                         [--ehs]
                                         [--mi-user-assigned]
                                         [--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.

--adx-database-name --adxd

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

--cn --conn-name

Name der Datenverlaufsverbindung.

--dt-name --dtn -n

Name der Digital Twins-Instanz.

--eh --eventhub

Name von EventHub zur Integration in.

--ehn --eventhub-namespace

EventHub-Namespacebezeichner.

Optionale Parameter

--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.

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.

Zulässige Werte: false, true
Standardwert: False
--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.

--adx-resource-group --adxg

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

--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.

--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.

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.

--ehc --eventhub-consumer-group

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

Standardwert: $Default
--ehg --eventhub-resource-group

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

--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.

--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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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.

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.