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
Name des Azure Data Explorer-Clusters für die Integration.
Name der Azure Data Explorer-Datenbank für die Integration.
Name der Datenverlaufsverbindung.
Name der Digital Twins-Instanz.
Name von EventHub zur Integration in.
EventHub-Namespacebezeichner.
Optionale Parameter
Der Name der Azure Data Explorer-Tabelle, die zum Speichern von Updates für Eigenschaften von Zwillingen und Beziehungen verwendet wird.
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.
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.
Name der Azure Data Explorer-Ressourcengruppe. Wenn nicht angegeben, wird die Ressourcengruppe von Digital Twin verwendet.
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.
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.
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.
Die EventHub-Consumergruppe, die verwendet werden soll, wenn ADX aus EventHub liest.
Name der EventHub-Ressourcengruppe. Wenn nicht angegeben, wird die Ressourcengruppe von Digital Twin verwendet.
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.
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.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Ressourcengruppe der Digital Twins-Instanz. Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Fordern Sie beim Zuweisen der erforderlichen Rollen keine Bestätigung auf.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.