az dt data-history connection create

Note

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.67.0 of hoger). De extensie wordt automatisch geïnstalleerd wanneer u een az dt data-history connection create opdracht uitvoert. Meer informatie over uitbreidingen.

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

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.

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

--adx-database-name --adxd

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

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

Eigenschap	Waarde
Parametergroep:	Event Hub Arguments

--ehn --eventhub-namespace

EventHub-naamruimte-id.

Eigenschap	Waarde
Parametergroep:	Event Hub Arguments

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments
Default value:	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.

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments
Default value:	False
Geaccepteerde waarden:	false, true

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

--adx-resource-group --adxg

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

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

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments
Default value:	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.

Eigenschap	Waarde
Parametergroep:	Azure Data Explorer Arguments

--ehc --eventhub-consumer-group

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

Eigenschap	Waarde
Parametergroep:	Event Hub Arguments
Default value:	$Default

--ehg --eventhub-resource-group

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

Eigenschap	Waarde
Parametergroep:	Event Hub Arguments

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

Eigenschap	Waarde
Parametergroep:	Event Hub Arguments

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

Eigenschap	Waarde
Default value:	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.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

Feedback

Is deze pagina nuttig?