az dt data-history connection create
Note
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane 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. |
Extension | 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 --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]
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
Nazwa klastra usługi Azure Data Explorer do integracji z.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
Nazwa bazy danych usługi Azure Data Explorer, z która ma być zintegrowana.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
Nazwa połączenia historii danych.
Nazwa wystąpienia usługi Digital Twins.
Nazwa usługi EventHub do integracji z.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Event Hub Arguments |
Identyfikator przestrzeni nazw usługi EventHub.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Event Hub Arguments |
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Nazwa tabeli usługi Azure Data Explorer używana do przechowywania aktualizacji właściwości bliźniaczych reprezentacji bliźniaczych i relacji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
| Domyślna wartość: | AdtPropertyEvents |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
Nazwa grupy zasobów usługi Azure Data Explorer. Jeśli nie zostanie podana, użyje grupy zasobów usługi Digital Twin.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
| Domyślna wartość: | AdtPropertyEvents |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Azure Data Explorer Arguments |
Grupa odbiorców usługi EventHub do użycia, gdy usługa ADX odczytuje z usługi EventHub.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Event Hub Arguments |
| Domyślna wartość: | $Default |
Nazwa grupy zasobów usługi EventHub. Jeśli nie zostanie podana, użyje grupy zasobów usługi Digital Twin.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Event Hub Arguments |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Event Hub Arguments |
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.
Nie czekaj na zakończenie długotrwałej operacji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group={name}.
Nie monituj o potwierdzenie podczas przypisywania wymaganych ról.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |