Dela via


az dt data-history connection create

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.46.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az dt data-history connection create . Läs mer om tillägg.

Skapar en datahistorikanslutning mellan en Digital Twins-instans och resurser som stöds.

Kommandon

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

Skapar en datahistorikanslutning mellan en Digital Twins-instans och en Azure Data Explorer-databas. Kräver förskapade Azure Data Explorer- och Event Hub-resurser.

Anknytning Allmän tillgänglighet

az dt data-history connection create adx

Skapar en datahistorikanslutning mellan en Digital Twins-instans och en Azure Data Explorer-databas. Kräver förskapade Azure Data Explorer- och Event Hub-resurser.

Uppmanar användaren att lägga till följande roller och behörigheter på Digital Twins-instansen eller den användartilldelade identitet som krävs för att skapa anslutningen:

  • Rollen Deltagare för Azure Data Explorer Database-omfånget
  • Databasadministratörsbehörighet för Azure Data Explorer Database-omfånget
  • Rollen "Azure Event Hubs-dataägare" för Event Hub-omfånget.
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]

Exempel

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med konsumentgruppen $Default Event Hub.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med hjälp av en användartilldelad identitet som är associerad med den digitala tvillingen med konsumentgruppen $Default Event Hub.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med ett anpassat Azure Data Explorer-tabellnamn och en händelsehubbkonsumentgrupp.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans som integreras med en Händelsehubb och Azure Data Explorer-instanser i olika resursgrupper och prenumerationer från målinstansen.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med konsumentgruppen $Default Event Hub och hoppar över rolltilldelningsprompterna.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med konsumentgruppen $Default Event Hub och aktiverar borttagning av postegenskap och objekt. Ytterligare en kolumn läggs till i tabellen som används för att lagra uppdateringar av egenskaper för tvillingar och relationer (standardvärdet är 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

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med konsumentgruppen $Default Event Hub och skapar två extra tabeller i Azure Data Explorer-databasen. En tabell kommer att användas för att registrera tvillinglivscykelhändelser och den andra för relationslivscykelhändelser.

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}

Lägger till en datahistorikanslutning till en Digital Twins-målinstans med konsumentgruppen $Default Event Hub, använder ett händelsetabellnamn för anpassad tvillingegenskap och skapar två extra tabeller i Azure Data Explorer-databasen.

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}

Obligatoriska parametrar

--adx-cluster-name --adxc

Namnet på Azure Data Explorer-klustret som ska integreras med.

--adx-database-name --adxd

Namnet på Azure Data Explorer-databasen som ska integreras med.

--cn --conn-name

Namn på anslutning till datahistorik.

--dt-name --dtn -n

Digital Twins-instansnamn.

--eh --eventhub

Namnet på EventHub att integrera med.

--ehn --eventhub-namespace

EventHub-namnområdesidentifierare.

Valfria parametrar

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

Namnet på den Azure Data Explorer-tabell som används för att lagra uppdateringar av egenskaper för tvillingar och relationer.

standardvärde: AdtPropertyEvents
--adx-record-removals --adxrr

Anger om du vill registrera tvilling-/relationsegenskap och objektborttagningar, inklusive borttagningar av indexerade eller nyckelade värden (till exempel mappningsposter, matriselement osv.). Om den här egenskapen anges till "true" genereras ytterligare en kolumn i tabellen egenskapshändelser i ADX.

accepterade värden: false, true
standardvärde: False
--adx-relationship-events-table --adxret

Namnet på den Azure Data Explorer-tabell som används för att registrera relationslivscykelhändelser. Tabellen skapas inte om den här egenskapen lämnas ospecificerad.

--adx-resource-group --adxg

Namnet på resursgruppen Azure Data Explorer. Om det inte anges använder du Digital Twin-resursgruppen.

--adx-subscription --adxs

Namn eller ID för prenumerationen där Azure Data Explorer finns. Om det inte anges använder du den prenumeration som innehåller Digital Twin-instansen.

--adx-table-name --adxt
Inaktuell

Alternativet "--adx-table-name" har föråldrats och tas bort i en framtida version. Använd "--adx-property-events-table" i stället.

Namnet på den Azure Data Explorer-tabell som används för att lagra uppdateringar av egenskaper för tvillingar och relationer.

standardvärde: AdtPropertyEvents
--adx-twin-events-table --adxtet

Namnet på den Azure Data Explorer-tabell som används för att registrera tvillinglivscykelhändelser. Tabellen skapas inte om den här egenskapen lämnas ospecificerad.

--ehc --eventhub-consumer-group

Den EventHub-konsumentgrupp som ska användas när ADX läser från EventHub.

standardvärde: $Default
--ehg --eventhub-resource-group

Namn på EventHub-resursgrupp. Om det inte anges använder du Digital Twin-resursgruppen.

--ehs --eventhub-subscription

Namn eller ID för prenumerationen där EventHub finns. Om det inte anges använder du den prenumeration som innehåller Digital Twin-instansen.

--mi-user-assigned --user

Använd en användartilldelad hanterad identitet för autentisering med datahistorikanslutning. Accepterar identitetens resurs-ID. Om det inte anges använder du systemidentiteten i stället.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--yes -y

Fråga inte efter bekräftelse när du tilldelar nödvändiga roller.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.