Delen via

az dt data-history connection create

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.46.0 of hoger). De extensie installeert automatisch de eerste keer dat u een opdracht voor het maken van een verbinding met az dt data-history uitvoert. Meer informatie over extensies.

Hiermee maakt u een gegevensgeschiedenisverbinding tussen een Digital Twins-exemplaar en ondersteunde resources.

Opdracht

Name Description Type Status
az dt data-history connection create adx

Hiermee maakt u een gegevensgeschiedenisverbinding tussen een Digital Twins-exemplaar en een Azure Data Explorer-database. Hiervoor zijn vooraf gemaakte Azure Data Explorer- en Event Hub-resources vereist.

 Toestel GA

az dt data-history connection create adx

Hiermee maakt u een gegevensgeschiedenisverbinding tussen een Digital Twins-exemplaar en een Azure Data Explorer-database. Hiervoor zijn vooraf gemaakte Azure Data Explorer- en Event Hub-resources vereist.

De gebruiker wordt gevraagd de volgende rollen en machtigingen toe te voegen aan het Digital Twins-exemplaar of de door de gebruiker toegewezen identiteit die nodig is om de verbinding te maken:

  • Rol 'Inzender' voor het Azure Data Explorer-databasebereik
  • Machtiging Databasebeheerder voor het Azure Data Explorer-databasebereik
  • De rol Azure Event Hubs-gegevenseigenaar voor het Event Hub-bereik.
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]

Voorbeelden

Voegt een gegevensgeschiedenisverbinding toe aan een doelexemplaren van Digital Twins met de $Default Event Hub-consumentengroep.

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}

Hiermee voegt u een gegevensgeschiedenisverbinding toe aan een doelexemplaar van Digital Twins met behulp van een door de gebruiker toegewezen identiteit die is gekoppeld aan de digitale dubbel met de $Default Event Hub-consumentengroep.

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}

Voegt een gegevensgeschiedenisverbinding toe aan een doelexemplaren van Digital Twins met een aangepaste Azure Data Explorer-tabelnaam en Event Hub-consumentengroep.

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}

Hiermee voegt u een gegevensgeschiedenisverbinding toe aan een Digital Twins-doelexemplaren die zijn geïntegreerd met een Event Hub- en Azure Data Explorer-exemplaar in verschillende resourcegroepen en abonnementen van het doelexemplaren.

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}

Hiermee voegt u een gegevensgeschiedenisverbinding toe aan een doelexemplaren van Digital Twins met de $Default Event Hub-consumentengroep en slaat u de prompts voor roltoewijzing over.

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}

Hiermee voegt u een gegevensgeschiedenisverbinding toe aan een digital Twins-doelexemplaren met de $Default Event Hub-consumentengroep en schakelt u recordeigenschap en itemverwijderingen in. Er wordt een extra kolom toegevoegd aan de tabel die wordt gebruikt voor het opslaan van updates voor eigenschappen van tweelingen en relaties (standaard ingesteld op 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

Voegt een gegevensgeschiedenisverbinding toe aan een Digital Twins-doelexemplaren met de $Default Event Hub-consumentengroep en maakt twee extra tabellen in de Azure Data Explorer-database. Eén tabel is bedoeld voor het vastleggen van levenscyclus-gebeurtenissen van dubbels en de andere voor levenscyclus-gebeurtenissen van relaties.

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}

Voegt een gegevensgeschiedenisverbinding toe aan een doelexemplaren van Digital Twins met de $Default Event Hub-consumentengroep, maakt gebruik van de naam van een aangepaste gebeurtenistabel met dubbeleigenschappen en maakt twee extra tabellen in de Azure Data Explorer-database.

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}

Vereiste parameters

--adx-cluster-name --adxc

De naam van het Azure Data Explorer-cluster waarmee moet worden geïntegreerd.

--adx-database-name --adxd

De naam van de Azure Data Explorer-database waarmee moet worden geïntegreerd.

--cn --conn-name

Naam van gegevensgeschiedenisverbinding.

--dt-name --dtn -n

Naam van digital Twins-exemplaar.

--eh --eventhub

Naam van EventHub waarmee moet worden geïntegreerd.

--ehn --eventhub-namespace

EventHub-naamruimte-id.

Optionele parameters

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

De naam van de Azure Data Explorer-tabel die wordt gebruikt voor het opslaan van updates voor eigenschappen van tweelingen en relaties.

standaardwaarde: AdtPropertyEvents
--adx-record-removals --adxrr

Hiermee geeft u op of dubbel-/relatie-eigenschap en itemverwijderingen moeten worden vastgelegd, inclusief verwijderingen van geïndexeerde of sleutelwaarden (zoals toewijzingsvermeldingen, matrixelementen, enzovoort). Als u deze eigenschap instelt op 'true', wordt er een extra kolom gegenereerd in de tabel met eigenschapsevenementen in ADX.

geaccepteerde waarden: false, true
standaardwaarde: False
--adx-relationship-events-table --adxret

De naam van de Azure Data Explorer-tabel die wordt gebruikt voor het vastleggen van levenscyclus-gebeurtenissen voor relaties. De tabel wordt niet gemaakt als deze eigenschap niet is opgegeven.

--adx-resource-group --adxg

Naam van Azure Data Explorer-resourcegroep. Als deze niet is opgegeven, gebruikt u de resourcegroep van de Digital Twin.

--adx-subscription --adxs

Naam of id van het abonnement waarin Azure Data Explorer bestaat. Als dit niet is opgegeven, gebruikt u het abonnement dat het Digital Twin-exemplaar bevat.

--adx-table-name --adxt
Afgeschaft

Optie '--adx-table-name' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--adx-property-events-table'.

De naam van de Azure Data Explorer-tabel die wordt gebruikt voor het opslaan van updates voor eigenschappen van tweelingen en relaties.

standaardwaarde: AdtPropertyEvents
--adx-twin-events-table --adxtet

De naam van de Azure Data Explorer-tabel die wordt gebruikt voor het vastleggen van levenscyclus-gebeurtenissen van dubbels. De tabel wordt niet gemaakt als deze eigenschap niet is opgegeven.

--ehc --eventhub-consumer-group

De EventHub-consumentengroep die moet worden gebruikt wanneer ADX uit EventHub leest.

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

De naam van de EventHub-resourcegroep. Als deze niet is opgegeven, gebruikt u de resourcegroep van de Digital Twin.

--ehs --eventhub-subscription

Naam of id van het abonnement waarin de EventHub bestaat. Als dit niet is opgegeven, gebruikt u het abonnement dat het Digital Twin-exemplaar bevat.

--mi-user-assigned --user

Gebruik een door de gebruiker toegewezen beheerde identiteit voor verificatie van gegevensgeschiedenisverbindingen. Accepteert de id van de identiteitsresource. Als dit niet is opgegeven, wordt in plaats daarvan de systeemidentiteit gebruikt.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

standaardwaarde: False
--resource-group -g

Resourcegroep voor Digital Twins-exemplaren. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--yes -y

Vraag niet om bevestiging bij het toewijzen van vereiste rollen.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.