Udostępnij za pośrednictwem

az dt data-history connection create

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az dt data-history connection create przy pierwszym uruchomieniu polecenia az dt data-history connection create . Dowiedz się więcej o rozszerzeniach.

Tworzy połączenie historii danych między wystąpieniem usługi Digital Twins i obsługiwanymi zasobami.

Polecenia

Nazwa Opis Typ Stan
az dt data-history connection create adx

Tworzy połączenie historii danych między wystąpieniem usługi Digital Twins i bazą danych usługi Azure Data Explorer. Wymaga wstępnie utworzonych zasobów usług Azure Data Explorer i Event Hub.

 Numer wewnętrzny Ogólna dostępność

az dt data-history connection create adx

Tworzy połączenie historii danych między wystąpieniem usługi Digital Twins i bazą danych usługi Azure Data Explorer. Wymaga wstępnie utworzonych zasobów usług Azure Data Explorer i Event Hub.

Monituje użytkownika o dodanie następujących ról i uprawnień do wystąpienia usługi Digital Twins lub tożsamości przypisanej przez użytkownika potrzebnego do pomyślnego utworzenia połączenia:

  • Rola "Współautor" dla zakresu bazy danych usługi Azure Data Explorer
  • Uprawnienie "Administrator bazy danych" dla zakresu bazy danych usługi Azure Data Explorer
  • Rola "Właściciel danych usługi Azure Event Hubs" dla zakresu centrum zdarzeń.
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]

Przykłady

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z grupą odbiorców usługi $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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins przy użyciu tożsamości przypisanej przez użytkownika skojarzonej z cyfrową reprezentacją bliźniaczą z grupą odbiorców usługi $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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z niestandardową nazwą tabeli usługi Azure Data Explorer i grupą odbiorców centrum zdarzeń.

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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins integrującym się z wystąpieniem centrum zdarzeń i usługi Azure Data Explorer w różnych grupach zasobów i subskrypcjach z wystąpienia docelowego.

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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z grupą odbiorców usługi $Default Event Hub i pomija monity o przypisanie roli.

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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z grupą odbiorców usługi $Default Event Hub i umożliwia usuwanie właściwości rekordów i elementów. Dodatkowa kolumna zostanie dodana do tabeli używanej do przechowywania aktualizacji właściwości bliźniaczych reprezentacji bliźniaczych i relacji (domyślnie 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

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z grupą odbiorców usługi $Default Event Hub i tworzy dwie dodatkowe tabele w bazie danych usługi Azure Data Explorer. Jedna tabela będzie zawierać rejestrowanie zdarzeń cyklu życia bliźniaczej reprezentacji i drugą dla zdarzeń cyklu życia relacji.

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}

Dodaje połączenie historii danych z docelowym wystąpieniem usługi Digital Twins z grupą odbiorców usługi $Default Event Hub, używa niestandardowej nazwy tabeli zdarzeń właściwości bliźniaczej reprezentacji i tworzy dwie dodatkowe tabele w bazie danych usługi Azure Data Explorer.

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}

Parametry wymagane

--adx-cluster-name --adxc

Nazwa klastra usługi Azure Data Explorer do integracji z.

--adx-database-name --adxd

Nazwa bazy danych usługi Azure Data Explorer, z która ma być zintegrowana.

--cn --conn-name

Nazwa połączenia historii danych.

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins.

--eh --eventhub

Nazwa usługi EventHub do integracji z.

--ehn --eventhub-namespace

Identyfikator przestrzeni nazw usługi EventHub.

Parametry opcjonalne

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

Nazwa tabeli usługi Azure Data Explorer używana do przechowywania aktualizacji właściwości bliźniaczych reprezentacji bliźniaczych i relacji.

wartość domyślna: AdtPropertyEvents
--adx-record-removals --adxrr

Określa, czy rejestrować właściwości bliźniaczej reprezentacji/relacji i usuwania elementów, w tym usuwania indeksowanych lub kluczowych wartości (takich jak wpisy mapy, elementy tablicy itp.). Ustawienie tej właściwości na wartość "true" spowoduje wygenerowanie dodatkowej kolumny w tabeli zdarzeń właściwości w usłudze ADX.

akceptowane wartości: false, true
wartość domyślna: False
--adx-relationship-events-table --adxret

Nazwa tabeli usługi Azure Data Explorer używana do rejestrowania zdarzeń cyklu życia relacji. Tabela nie zostanie utworzona, jeśli ta właściwość nie zostanie określona.

--adx-resource-group --adxg

Nazwa grupy zasobów usługi Azure Data Explorer. Jeśli nie zostanie podana, użyje grupy zasobów usługi Digital Twin.

--adx-subscription --adxs

Nazwa lub identyfikator subskrypcji, w której istnieje usługa Azure Data Explorer. Jeśli nie zostanie podana, użyje subskrypcji zawierającej wystąpienie usługi Digital Twin.

--adx-table-name --adxt
Przestarzałe

Opcja "--adx-table-name" została wycofana i zostanie usunięta w przyszłej wersji. Zamiast tego użyj polecenia "--adx-property-events-table".

Nazwa tabeli usługi Azure Data Explorer używana do przechowywania aktualizacji właściwości bliźniaczych reprezentacji bliźniaczych i relacji.

wartość domyślna: AdtPropertyEvents
--adx-twin-events-table --adxtet

Nazwa tabeli usługi Azure Data Explorer używana do rejestrowania zdarzeń cyklu życia bliźniaczej reprezentacji. Tabela nie zostanie utworzona, jeśli ta właściwość nie zostanie określona.

--ehc --eventhub-consumer-group

Grupa odbiorców usługi EventHub do użycia, gdy usługa ADX odczytuje z usługi EventHub.

wartość domyślna: $Default
--ehg --eventhub-resource-group

Nazwa grupy zasobów usługi EventHub. Jeśli nie zostanie podana, użyje grupy zasobów usługi Digital Twin.

--ehs --eventhub-subscription

Nazwa lub identyfikator subskrypcji, w której istnieje usługa EventHub. Jeśli nie zostanie podana, użyje subskrypcji zawierającej wystąpienie usługi Digital Twin.

--mi-user-assigned --user

Użyj tożsamości zarządzanej przypisanej przez użytkownika na potrzeby uwierzytelniania połączenia historii danych. Akceptuje identyfikator zasobu tożsamości. Jeśli nie zostanie podana, zamiast tego użyje tożsamości systemowej.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--yes -y

Nie monituj o potwierdzenie podczas przypisywania wymaganych ról.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.