Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La cronologia dei dati è una funzionalità di integrazione di Gemelli digitali di Azure. Consente di connettere un'istanza di Gemelli digitali di Azure a un cluster di Esplora dati di Azure in modo che gli aggiornamenti del grafo vengano automaticamente istorizzati in Esplora dati di Azure. Questi aggiornamenti istorizzati includono gli aggiornamenti delle proprietà gemelle, gli eventi del ciclo di vita dei gemelli e gli eventi del ciclo di vita delle relazioni.
Dopo che gli aggiornamenti del grafo vengono istorizzati in Esplora dati di Azure, è possibile eseguire query comuni usando il plug-in Gemelli digitali di Azure per Esplora dati di Azure per ragionare tra gemelli digitali, le relative relazioni e i dati delle serie temporali. Può essere usato per esaminare in tempo lo stato del grafico usato per ottenere informazioni dettagliate sul comportamento degli ambienti modellati. È anche possibile usare queste query per ottimizzare i dashboard operativi, arricchire le applicazioni Web 2D e 3D e favorire esperienze immersive di realtà aumentata/mista per trasmettere lo stato attuale e cronologico di asset, processi e persone modellati in Gemelli digitali di Azure.
Per altre informazioni sulla cronologia dei dati, inclusa una demo rapida, guardare il video seguente:
I messaggi emessi dalla cronologia dei dati sono misurati nella dimensione dei prezzi dei messaggi.
Prerequisiti: risorse e autorizzazioni
La cronologia dei dati richiede le risorse seguenti:
- Istanza di Gemelli digitali di Azure, con un'identità gestita assegnata dal sistema abilitata.
- Spazio dei nomi Event Hubs contenente un Event Hub.
- Cluster di Azure Data Explorer che contiene un database. Il cluster deve avere l'accesso alla rete pubblica abilitato.
Queste risorse sono connesse al flusso seguente:
Diagramma che mostra il flusso dei dati di telemetria dei dispositivi nei Gemelli Digitali di Azure, attraverso un Hub Eventi, verso Esplora Dati di Azure.
Quando il grafo dei gemelli digitali viene aggiornato, le informazioni passano attraverso l'Hub eventi nel cluster di destinazione di Azure Data Explorer, dove Azure Data Explorer archivia i dati come record con marca temporale nella tabella corrispondente.
Quando si usa la cronologia dei dati, è consigliabile usare la versione 2023-01-31 o successiva delle API. Con la versione 2022-05-31 , è possibile istorizzare solo le proprietà gemelle (non gli eventi relativi al ciclo di vita dei gemelli o al ciclo di vita delle relazioni). Con le versioni precedenti, la cronologia dei dati non è disponibile.
Autorizzazioni necessarie
Per configurare una connessione alla cronologia dati, l'istanza di Azure Digital Twins deve avere le autorizzazioni seguenti per accedere alle risorse di Event Hubs e Azure Data Explorer. Questi ruoli consentono a Gemelli digitali di Azure di configurare l'hub eventi e il database di Esplora dati di Azure per conto dell'utente, ad esempio creando una tabella nel database. Queste autorizzazioni possono essere rimosse facoltativamente dopo la configurazione della cronologia dei dati.
- Risorsa di Hub eventi: Proprietario dei dati di Azure Event Hubs
- Cluster di Azure Data Explorer: Collaboratore (applicato all'intero cluster o a un database specifico)
- Assegnazione dei principali di database di Esplora dati di Azure: amministratore (limitato al database in uso)
Successivamente, l'istanza di Gemelli digitali di Azure deve avere l'autorizzazione seguente per la risorsa di Hub eventi durante l'utilizzo della cronologia dei dati: Mittente dati di Hub eventi di Azure. È anche possibile optare invece per mantenere Azure Event Hubs Data Owner dalla configurazione della cronologia dei dati.
Queste autorizzazioni possono essere assegnate usando l'interfaccia della riga di comando di Azure o il portale di Azure.
Se si vuole limitare l'accesso di rete alle risorse coinvolte nella cronologia dei dati (l'istanza di Gemelli digitali di Azure, l'hub eventi o il cluster di Esplora dati di Azure), è necessario impostare tali restrizioni dopo aver configurato la connessione alla cronologia dati. Per altre informazioni su questo processo, vedere Limitare l'accesso di rete alle risorse della cronologia dei dati.
Creare e gestire la connessione alla cronologia dei dati
Questa sezione contiene informazioni per la creazione, l'aggiornamento e l'eliminazione di una connessione alla cronologia dati.
Creare una connessione alla cronologia dei dati
Dopo aver configurato tutte le risorse e le autorizzazioni, è possibile usare l'interfaccia della riga di comando di Azure, il portale di Azure o Azure Digital Twins SDK per creare la connessione alla cronologia dei dati tra di esse. Il set di comandi dell'interfaccia a riga di comando è az dt data-history.
Il comando creerà sempre una tabella per gli eventi di proprietà twin storicizzati, che possono usare il nome predefinito o un nome personalizzato specificato. Le eliminazioni delle proprietà gemelle possono essere facoltativamente incluse in questa tabella. È anche possibile specificare nomi di tabella per gli eventi del ciclo di vita delle relazioni e gli eventi del ciclo di vita dei gemelli e il comando creerà tabelle con tali nomi per istorizzare tali tipi di evento.
Per istruzioni dettagliate su come configurare una connessione alla cronologia dati, vedere Creare una connessione cronologia dati.
Cronologia di più istanze di Azure Digital Twins
Se si desidera, è possibile avere più istanze di Azure Digital Twins che storicizzano gli aggiornamenti nello stesso cluster di Azure Data Explorer.
Ogni istanza di Gemelli Digitali di Azure avrà la propria connessione dei dati storici destinata allo stesso cluster di Azure Data Explorer. All'interno del cluster, le istanze possono inviare i propri dati gemelli a entrambe le...
- un set separato di tabelle nel cluster di Esplora dati di Azure.
-
lo stesso set di tabelle nel cluster di Esplora dati di Azure. A tale scopo, specificare gli stessi nomi di tabella di Azure Data Explorer mentre si creano le connessioni per la cronologia dei dati. Negli schemi della tabella della cronologia dei dati, la
ServiceIdcolonna in ogni tabella conterrà l'URL dell'istanza di Gemelli digitali di Azure di origine, quindi è possibile usare questo campo per risolvere l'istanza di Gemelli digitali di Azure che ha generato ogni record nelle tabelle condivise.
Aggiornare una connessione alla cronologia dei dati di sola proprietà
Prima di febbraio 2023, la funzione di storicizzazione dei dati includeva solo gli aggiornamenti delle proprietà dei gemelli digitali. Se si dispone di una connessione alla cronologia dati solo proprietà da quel momento, è possibile aggiornarla per storicizzare tutti gli aggiornamenti del grafo su Azure Data Explorer (incluse le proprietà gemelle, gli eventi del ciclo di vita delle istanze gemelle e gli eventi del ciclo di vita delle relazioni).
Ciò richiederà la creazione di nuove tabelle nel cluster di Azure Data Explorer per i nuovi tipi di aggiornamenti storici (eventi del ciclo di vita dei gemelli digitali ed eventi del ciclo di vita delle relazioni). Per gli eventi delle proprietà gemelle, è possibile decidere se si vuole che la nuova connessione continui a usare la stessa tabella dalla connessione della cronologia dati originale per archiviare gli aggiornamenti delle proprietà gemelle in futuro o se si vuole che la nuova connessione usi un nuovo set di tabelle. Poi, segui le istruzioni riportate di seguito per la tua preferenza.
Se si vuole continuare a usare la tabella esistente per gli aggiornamenti delle proprietà gemelle: Usare le istruzioni riportate in Creare una connessione cronologia dati per creare una nuova connessione alla cronologia dati con le nuove funzionalità. Il nome della connessione della cronologia dati può essere identico a quello originale oppure diverso. Usare le opzioni dei parametri per specificare nuovi nomi per le due nuove tabelle dei tipi di evento e passare il nome della tabella originale per la tabella degli aggiornamenti delle proprietà gemelle. La nuova connessione sostituirà quella precedente e continuerà a utilizzare la tabella originale per futuri aggiornamenti delle proprietà dei gemelli storicizzati.
Per usare tutte le nuove tabelle: Prima di tutto, eliminare la connessione della cronologia dati originale. Usare quindi le istruzioni in Creare una connessione cronologia dati per creare una nuova connessione alla cronologia dati con le nuove funzionalità. Il nome della connessione della cronologia dati può essere identico a quello originale oppure diverso. Usare le opzioni dei parametri per specificare nuovi nomi per tutte e tre le tabelle dei tipi di evento.
Eliminare una connessione alla cronologia dati
È possibile usare l'interfaccia della riga di comando di Azure, il portale di Azure o le API e gli SDK di Gemelli digitali di Azure per eliminare una connessione alla cronologia dei dati. Il comando CLI è az dt data-history connection delete.
L'eliminazione di una connessione offre anche la possibilità di pulire le risorse associate alla connessione alla cronologia dati (per il comando dell'interfaccia della riga di comando, il parametro facoltativo da aggiungere è --clean true). Se si usa questa opzione, il comando eliminerà le risorse in Esplora dati di Azure usate per collegare il cluster all'hub eventi, incluse le connessioni dati per il database e i mapping di inserimento associati alla tabella. L'opzione "pulire le risorse" non eliminerà il vero hub eventi e il cluster di Azure Data Explorer utilizzati per la connessione alla cronologia dei dati.
La pulizia è un tentativo di lavoro ottimale e richiede che l'account che esegue il comando disponga dell'autorizzazione di eliminazione per queste risorse.
Annotazioni
Se si dispone di più connessioni di cronologia dati che condividono lo stesso hub eventi o lo stesso cluster di Esplora dati di Azure, usando l'opzione "pulire le risorse" durante l'eliminazione di una di queste connessioni potrebbe interrompere le altre connessioni della cronologia dei dati che si basano su queste risorse.
Tipi di dati e schemi
La cronologia dei dati storicizza tre tipi di eventi dalla tua istanza di Azure Digital Twins in Esplora dati di Azure: eventi del ciclo di vita delle relazioni, eventi del ciclo di vita dei gemelli e aggiornamenti delle proprietà dei gemelli (che possono anche includere eliminazioni delle proprietà dei gemelli). Ognuno di questi tipi di evento viene archiviato nella propria tabella all'interno del database di Esplora dati di Azure, cioè la cronologia dei dati viene mantenuta in un totale di tre tabelle. È possibile specificare nomi personalizzati per le tabelle quando si configura la connessione alla cronologia dati.
Nella parte restante di questa sezione vengono descritte in dettaglio le tre tabelle di Esplora dati di Azure, incluso lo schema dei dati per ogni tabella.
Aggiornamenti delle proprietà gemelle
La tabella esplora dati di Azure per gli aggiornamenti delle proprietà gemelli ha un nome predefinito adtPropertyEvents. È possibile lasciare il nome predefinito quando si crea la connessione o specificare un nome di tabella personalizzato.
I dati delle serie temporali per gli aggiornamenti delle proprietà gemelle vengono archiviati con lo schema seguente:
| Attributo | TIPO | Descrizione |
|---|---|---|
TimeStamp |
Data e ora | Data/ora in cui il messaggio di aggiornamento della proprietà è stato elaborato da Gemelli digitali di Azure. Questo campo viene impostato dal sistema e non è scrivibile dagli utenti. |
SourceTimeStamp |
Data e ora | Proprietà facoltativa scrivibile che rappresenta il timestamp quando l'aggiornamento della proprietà è stato osservato nel mondo reale. Questa proprietà può essere scritta solo usando la versione 2022-05-31 delle API/SDK di Gemelli digitali di Azure e il valore deve essere conforme al formato di data e ora ISO 8601. Per altre informazioni su come aggiornare questa proprietà, vedere Aggiornare sourceTime di una proprietà. |
ServiceId |
Stringa | ID dell'istanza del servizio Azure IoT che registra il record |
Id |
Stringa | ID gemello |
ModelId |
Stringa | ID del modello DTDL (DTMI) |
Key |
Stringa | Nome della proprietà aggiornata |
Value |
Dinamico | Valore della proprietà aggiornata |
RelationshipId |
Stringa | Quando viene aggiornata una proprietà specifica di una relazione, anziché di dispositivi gemelli o singoli, questo campo viene popolato con l'ID della relazione. Quando viene aggiornata una proprietà gemella , questo campo è vuoto. |
RelationshipTarget |
Stringa | Quando una proprietà definita su una relazione (anziché su gemelli o dispositivi) viene aggiornata, questo campo viene popolato con l'ID gemello del gemello mirato dalla relazione. Quando viene aggiornata una proprietà gemella , questo campo è vuoto. |
Action |
Stringa | Questa colonna esiste solo se si sceglie di storicizzare gli eventi di eliminazione delle proprietà. In tal caso, questa colonna contiene il tipo di evento della proprietà gemella (evento di aggiornamento o di eliminazione) |
Di seguito è riportata una tabella di esempio degli aggiornamenti delle proprietà gemelli archiviati in Esplora dati di Azure.
TimeStamp |
SourceTimeStamp |
ServiceId |
Id |
ModelId |
Key |
Value |
RelationshipTarget |
RelationshipID |
|---|---|---|---|---|---|---|---|---|
| 2022-12-15 20:23:29.8697482 | 2022-12-15 20:22:14.3854859 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A01 | dtmi:assetGen:PasteurizationMachine;1 |
Risultato | 130 | ||
| 2022-12-15 20:23:39.3235925 | 2022-12-15 20:22:26.5837559 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A01 | dtmi:assetGen:PasteurizationMachine;1 |
Risultato | 140 | ||
| 2022-12-15 20:23:47.078367 | 2022-12-15 20:22:34.9375957 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A01 | dtmi:assetGen:PasteurizationMachine;1 |
Risultato | 130 | ||
| 2022-12-15 20:23:57.3794198 | 2022-12-15 20:22:50.1028562 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A01 | dtmi:assetGen:PasteurizationMachine;1 |
Risultato | 123 |
Rappresentazione delle proprietà con più campi
Potrebbe essere necessario archiviare una proprietà con più campi. Queste proprietà sono rappresentate con un oggetto JSON nell'attributo Value dello schema.
Ad esempio, se si rappresenta una proprietà con tre campi per roll, pitch e yaw, la cronologia dei dati archivierà l'oggetto JSON seguente come Value: {"roll": 20, "pitch": 15, "yaw": 45}.
Eventi del ciclo di vita dei gemelli
La tabella esplora dati di Azure per gli eventi del ciclo di vita dei gemelli ha un nome personalizzato che verrà specificato durante la creazione della connessione alla cronologia dati.
I dati delle serie temporali per gli eventi del ciclo di vita dei gemelli vengono archiviati con lo schema seguente:
| Attributo | TIPO | Descrizione |
|---|---|---|
TwinId |
Stringa | ID gemello |
Action |
Stringa | Tipo di evento del ciclo di vita del gemello (creazione o eliminazione) |
TimeStamp |
Data e ora | Data/ora in cui l'evento del ciclo di vita del gemello è stato elaborato da Azure Digital Twins. Questo campo viene impostato dal sistema e non è scrivibile dagli utenti. |
ServiceId |
Stringa | ID dell'istanza del servizio Azure IoT che registra il record |
ModelId |
Stringa | ID del modello DTDL (DTMI) |
Di seguito è riportata una tabella di esempio degli aggiornamenti del ciclo di vita dei gemelli archiviati in Esplora dati di Azure.
TwinId |
Action |
TimeStamp |
ServiceId |
ModelId |
|---|---|---|---|---|
| PasteurizationMachine_A01 | Creazione | 2022-12-15 07:14:12.4160 | dairyadtinstance.api.wcus.digitaltwins.azure.net | dtmi:assetGen:PasteurizationMachine;1 |
| PasteurizationMachine_A02 | Creazione | 2022-12-15 07:14:12.4210 | dairyadtinstance.api.wcus.digitaltwins.azure.net | dtmi:assetGen:PasteurizationMachine;1 |
| SaltMachine_C0 | Creazione | 2022-12-15 07:14:12.5480 | dairyadtinstance.api.wcus.digitaltwins.azure.net | dtmi:assetGen:SaltMachine;1 |
| PasteurizationMachine_A02 | Cancella | 2022-12-15 07:15:49.6050 | dairyadtinstance.api.wcus.digitaltwins.azure.net | dtmi:assetGen:PasteurizationMachine;1 |
Eventi del ciclo di vita delle relazioni
La tabella esplora dati di Azure per gli eventi del ciclo di vita delle relazioni ha un nome personalizzato che verrà specificato durante la creazione della connessione alla cronologia dei dati.
I dati delle serie temporali per gli eventi del ciclo di vita delle relazioni vengono archiviati con lo schema seguente:
| Attributo | TIPO | Descrizione |
|---|---|---|
RelationshipId |
Stringa | L'ID di relazione. Questo campo viene impostato dal sistema e non è scrivibile dagli utenti. |
Name |
Stringa | Nome della relazione |
Action |
Tipo di evento del ciclo di vita della relazione (creazione o eliminazione) | |
TimeStamp |
Data e ora | Data/ora in cui l'evento del ciclo di vita della relazione è stato elaborato da Gemelli digitali di Azure. Questo campo viene impostato dal sistema e non è scrivibile dagli utenti. |
ServiceId |
ID dell'istanza del servizio Azure IoT che registra il record | |
Source |
ID del gemello di origine. Si tratta dell'ID del gemello da cui ha origine la relazione. | |
Target |
ID del gemello di destinazione. Si tratta dell'ID del gemello dove arriva la relazione. |
Di seguito è riportata una tabella di esempio degli aggiornamenti del ciclo di vita delle relazioni archiviati in Esplora dati di Azure.
RelationshipId |
Name |
Action |
TimeStamp |
ServiceId |
Source |
Target |
|---|---|---|---|---|---|---|
| PasteurizationMachine_A01_feeds_Relationship0 | Feed | Creazione | 2022-12-15 07:16:12.7120 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A01 | SaltMachine_C0 |
| PasteurizationMachine_A02_feeds_Relationship0 | Feed | Creazione | 2022-12-15 07:16:12.7160 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A02 | SaltMachine_C0 |
| PasteurizationMachine_A03_feeds_Relationship0 | Feed | Creazione | 2022-12-15 07:16:12.7250 | dairyadtinstance.api.wcus.digitaltwins.azure.net | PasteurizationMachine_A03 | SaltMachine_C1 |
| OsloFactory_contiene_Relazione0 | contiene | Cancella | 2022-12-15 07:16:13.1780 | dairyadtinstance.api.wcus.digitaltwins.azure.net | OsloFactory | SaltMachine_C0 |
Latenza di inserimento end-to-end
La cronologia dei dati di Azure Digital Twins si basa sul meccanismo di inserimento esistente fornito da Azure Data Explorer. Azure Digital Twins garantiranno che gli eventi di aggiornamento del grafo siano resi disponibili su Esplora dati di Azure entro meno di due secondi. L'inserimento dei dati da parte di Azure Data Explorer può introdurre latenza aggiuntiva.
In Esplora dati di Azure sono disponibili due metodi per l'inserimento di dati: inserimento batch e inserimento in streaming. È possibile configurare questi metodi di inserimento per singole tabelle in base alle esigenze e allo scenario di inserimento dati specifico.
L'inserimento in streaming ha la latenza più bassa. Tuttavia, a causa del sovraccarico di elaborazione, questa modalità deve essere usata solo se vengono inseriti meno di 4 GB di dati ogni ora. L'inserimento batch funziona meglio se sono previste frequenze elevate dei dati di inserimento. Azure Data Explorer usa l'inserimento batch per impostazione predefinita. La tabella seguente riepiloga la latenza end-to-end nel peggiore dei casi prevista.
| Configurazione di Azure Data Explorer | Latenza end-to-end prevista | Frequenza dei dati consigliata |
|---|---|---|
| Ingestione in streaming | <12 sec (<3 sec tipico) | <4 GB/ora |
| Inserimento batch | Varia (12 sec-15 m, a seconda della configurazione) | >4 GB/ora |
La parte restante di questa sezione contiene le informazioni dettagliate per l'abilitazione di ogni tipo di acquisizione.
Inserimento in gruppo (impostazione predefinita)
Se non è configurato in caso contrario, Esplora dati di Azure userà l'inserimento batch. Le impostazioni predefinite possono causare la disponibilità dei dati per la query solo 5-10 minuti dopo l'esecuzione di un aggiornamento a un gemello digitale. I criteri di inserimento possono essere modificati, in modo che l'elaborazione batch venga eseguita al massimo ogni 10 secondi (almeno 15 minuti al massimo). Per modificare i criteri di inserimento, è necessario eseguire il comando seguente nella visualizzazione query di Esplora dati di Azure:
.alter table <table_name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'
Assicurati che <table_name> sia sostituito con il nome della tabella che è stata predisposta per te. MaximumBatchingTimeSpan deve essere impostato sull'intervallo di invio in batch preferito. L'applicazione del criterio può richiedere da 5 a 10 minuti. Per altre informazioni sull'inserimento in batch, vedere il collegamento seguente: Comando di gestione dei criteri Kusto IngestionBatching.
Ingestione in streaming
L'abilitazione dell'inserimento in streaming è un processo in due passaggi:
- Abilita la funzione di inserimento in streaming per il tuo cluster. Questa azione deve essere eseguita una sola volta. (Avviso: questa operazione avrà un effetto sulla quantità di spazio di archiviazione disponibile per la cache ad accesso frequente e potrebbe introdurre limitazioni aggiuntive). Per istruzioni, vedere Configurare l'inserimento in streaming nel cluster di Azure Data Explorer.
- Aggiungere un criterio di inserimento di streaming per la tabella desiderata. Per ulteriori informazioni sull'abilitazione dell'ingestione in streaming per il cluster, vedere la documentazione di Azure Data Explorer: comando di gestione dei criteri Kusto IngestionBatching.
Per abilitare l'ingestione in streaming per la tabella della cronologia dei dati di Azure Digital Twins, è necessario eseguire il comando seguente nel riquadro delle query di Azure Data Explorer.
.alter table <table_name> policy streamingingestion enable
Assicurati che <table_name> sia sostituito con il nome della tabella che è stata predisposta per te. L'applicazione del criterio può richiedere da 5 a 10 minuti.
Visualizzare le proprietà istorizzate
Azure Digital Twins Explorer, uno strumento di sviluppo per la visualizzazione e l'interazione con i dati di Gemelli digitali di Azure, offre una funzionalità di esplorazione della cronologia dei dati per la visualizzazione delle proprietà istorizzate nel tempo in un grafico o in una tabella. Questa funzionalità è disponibile anche in 3D Scenes Studio, un ambiente 3D immersivo per offrire a Gemelli digitali di Azure il contesto visivo degli asset 3D.
Per informazioni più dettagliate sull'uso dell'esploratore della cronologia dei dati, vedere Validare ed esplorare le proprietà storicizzate.
Annotazioni
Se si verificano problemi durante la selezione di una proprietà nell'esperienza di esplorazione della cronologia dei dati visivi, potrebbe significare che c'è un errore in un modello della tua istanza. Ad esempio, la presenza di valori di enumerazione non univoci negli attributi di un modello interromperà questa funzionalità di visualizzazione. In questo caso, esaminare le definizioni del modello e assicurarsi che tutte le proprietà siano valide.
Passaggi successivi
Dopo aver istorizzato i dati gemelli in Esplora dati di Azure, è possibile usare il plug-in di query di Gemelli digitali di Azure per Esplora dati di Azure per eseguire query tra i dati. Altre informazioni sul plug-in sono disponibili qui: Esecuzione di query con il plug-in Esplora dati di Azure.
In alternativa, approfondire la cronologia dei dati con le istruzioni di creazione e uno scenario di esempio: Creare una connessione alla cronologia dati.