az dt data-history connection create

Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az dt data-history connection create . Altre informazioni sulle estensioni.

Crea una connessione cronologia dati tra un'istanza di Gemelli digitali e le risorse supportate.

Comandi

Nome	Descrizione	Tipo	Stato
az dt data-history connection create adx	Crea una connessione cronologia dati tra un'istanza di Gemelli digitali e un database di Azure Esplora dati. Richiede risorse di Azure Esplora dati e hub eventi già create.	Estensione	Disponibilità generale

az dt data-history connection create adx

Crea una connessione cronologia dati tra un'istanza di Gemelli digitali e un database di Azure Esplora dati. Richiede risorse di Azure Esplora dati e hub eventi già create.

Chiederà all'utente di aggiungere i ruoli e le autorizzazioni seguenti per l'istanza di Gemelli digitali o l'identità assegnata dall'utente necessaria per creare correttamente la connessione:

Ruolo "Collaboratore" per l'ambito del database di Azure Esplora dati
Autorizzazione 'Amministratore database' per l'ambito del database di Azure Esplora dati
Ruolo "Hub eventi di Azure Proprietario dati" per l'ambito dell'hub eventi.

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]

Esempio

Aggiunge una connessione cronologia dati a un'istanza di Gemelli digitali di destinazione con il gruppo di consumer dell'hub eventi $Default.

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}

Aggiunge una connessione cronologia dati a un'istanza di Gemelli digitali di destinazione usando un'identità assegnata dall'utente associata al gemello digitale con il gruppo di consumer dell'hub eventi $Default.

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}

Aggiunge una connessione della cronologia dati a un'istanza di Gemelli digitali di destinazione con un nome di tabella personalizzato di Azure Esplora dati e un gruppo di consumer dell'hub eventi.

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}

Aggiunge una connessione di cronologia dati a un'istanza di Gemelli digitali di destinazione che si integra con un hub eventi e istanze di Azure Esplora dati in diversi gruppi di risorse e sottoscrizioni dall'istanza di destinazione.

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}

Aggiunge una connessione cronologia dati a un'istanza di Gemelli digitali di destinazione con il gruppo di consumer dell'hub eventi $Default e ignora le richieste di assegnazione di ruolo.

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}

Aggiunge una connessione cronologia dati a un'istanza di Gemelli digitali di destinazione con il gruppo di consumer dell'hub eventi $Default e abilita la rimozione di proprietà e elementi di record. Verrà aggiunta una colonna aggiuntiva alla tabella usata per l'archiviazione degli aggiornamenti alle proprietà dei dispositivi gemelli e delle relazioni (per impostazione predefinita 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

Aggiunge una connessione cronologia dati a un'istanza di Gemelli digitali di destinazione con il gruppo di consumer dell'hub eventi $Default e crea due tabelle aggiuntive nel database di Azure Esplora dati. Una tabella sarà per la registrazione degli eventi del ciclo di vita dei gemelli e l'altra per gli eventi del ciclo di vita delle relazioni.

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}

Aggiunge una connessione di cronologia dati a un'istanza di Gemelli digitali di destinazione con il gruppo di consumer dell'hub eventi di $Default, usa un nome di tabella eventi della proprietà gemello personalizzata e crea due tabelle aggiuntive nel database di Azure Esplora dati.

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}

Parametri necessari

--adx-cluster-name --adxc

Nome del cluster Esplora dati di Azure con cui eseguire l'integrazione.

--adx-database-name --adxd

Nome del database Esplora dati di Azure con cui eseguire l'integrazione.

--cn --conn-name

Nome della connessione alla cronologia dati.

--dt-name --dtn -n

Nome dell'istanza di Gemelli digitali.

--eh --eventhub

Nome di EventHub con cui eseguire l'integrazione.

--ehn --eventhub-namespace

Identificatore dello spazio dei nomi EventHub.

Parametri facoltativi

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

Nome della tabella Esplora dati di Azure usata per l'archiviazione degli aggiornamenti alle proprietà di gemelli e relazioni.

valore predefinito: AdtPropertyEvents

--adx-record-removals --adxrr

Specifica se registrare o meno la proprietà gemella/relazione e le rimozioni degli elementi, incluse le rimozioni di valori indicizzati o con chiave (ad esempio voci della mappa, elementi di matrice e così via). L'impostazione di questa proprietà su 'true' genererà una colonna aggiuntiva nella tabella degli eventi delle proprietà in ADX.

valori accettati: false, true

valore predefinito: False

--adx-relationship-events-table --adxret

Nome della tabella Esplora dati di Azure usata per registrare gli eventi del ciclo di vita delle relazioni. La tabella non verrà creata se questa proprietà non viene specificata.

--adx-resource-group --adxg

Nome del gruppo di risorse di Azure Esplora dati. Se non specificato, userà il gruppo di risorse di Gemelli digitali.

--adx-subscription --adxs

Nome o ID della sottoscrizione in cui esiste il Esplora dati di Azure. Se non specificato, userà la sottoscrizione che contiene l'istanza di Gemelli digitali.

--adx-table-name --adxt

Deprecato

L'opzione '--adx-table-name' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--adx-property-events-table'.

Nome della tabella Esplora dati di Azure usata per l'archiviazione degli aggiornamenti alle proprietà di gemelli e relazioni.

valore predefinito: AdtPropertyEvents

--adx-twin-events-table --adxtet

Nome della tabella Esplora dati di Azure usata per registrare gli eventi del ciclo di vita dei gemelli. La tabella non verrà creata se questa proprietà non viene specificata.

--ehc --eventhub-consumer-group

Gruppo di consumer EventHub da usare quando ADX legge da EventHub.

valore predefinito: $Default

--ehg --eventhub-resource-group

Nome del gruppo di risorse EventHub. Se non specificato, userà il gruppo di risorse di Gemelli digitali.

--ehs --eventhub-subscription

Nome o ID della sottoscrizione in cui è presente EventHub. Se non specificato, userà la sottoscrizione che contiene l'istanza di Gemelli digitali.

--mi-user-assigned --user

Usare un'identità gestita assegnata dall'utente per l'autenticazione della connessione alla cronologia dati. Accetta l'ID risorsa di identità. Se non specificato, userà invece l'identità di sistema.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False

--resource-group -g

Gruppo di risorse dell'istanza di Gemelli digitali. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--yes -y

Non richiedere conferma quando si assegnano i ruoli obbligatori.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Condividi tramite

az dt data-history connection create

Comandi

az dt data-history connection create adx

Esempio

Parametri necessari

Parametri facoltativi

Risorse aggiuntive