Creare una connessione cronologia dati per Gemelli digitali di Azure

  • Articolo

La cronologia dei dati è una funzionalità di Gemelli digitali di Azure per l'istorizzazione automatica degli aggiornamenti del grafo in Azure Esplora dati. È possibile eseguire query su questi dati usando il plug-in di query di Gemelli digitali di Azure per Azure Esplora dati per ottenere informazioni dettagliate sull'ambiente nel tempo.

Questo articolo illustra come configurare una connessione di cronologia dati funzionante tra Gemelli digitali di Azure e Azure Esplora dati. Usa l'interfaccia della riga di comando di Azure e il portale di Azure per configurare e connettere le risorse della cronologia dei dati necessarie, tra cui:

Contiene anche un grafico dei gemelli di esempio che è possibile usare per visualizzare gli aggiornamenti del grafo istorizzato in Azure Esplora dati.

Suggerimento

Anche se questo articolo usa la portale di Azure, è anche possibile usare la cronologia dei dati usando la versione 2022-05-31 delle API rest.

Prerequisiti

Preparare l'ambiente per l'interfaccia della riga di comando di Azure

Nota

È anche possibile usare Azure Cloud Shell nell'ambiente PowerShell anziché nell'ambiente Bash, se si preferisce. I comandi in questa pagina vengono scritti per l'ambiente Bash, quindi potrebbero essere necessarie alcune piccole modifiche da eseguire in PowerShell.

Configurare la sessione dell'interfaccia della riga di comando

Per iniziare a usare Gemelli digitali di Azure nell'interfaccia della riga di comando, è prima di tutto necessario accedere e impostare il contesto dell'interfaccia della riga di comando sulla sottoscrizione per questa sessione. Eseguire questi comandi nella finestra dell'interfaccia della riga di comando:

az login
az account set --subscription "<your-Azure-subscription-ID>"

Suggerimento

Nel comando riportato sopra si può anche usare il nome della sottoscrizione invece dell'ID.

Se è la prima volta che si usa questa sottoscrizione con Gemelli digitali di Azure, eseguire questo comando per registrarsi con lo spazio dei nomi di Gemelli digitali di Azure. In caso di dubbi, è possibile eseguirlo di nuovo anche se è stato già completato nel passato.

az provider register --namespace 'Microsoft.DigitalTwins'

Si aggiungerà quindi l'estensione Microsoft Azure IoT per l'interfaccia della riga di comando di Azure per abilitare i comandi per interagire con Gemelli digitali di Azure e altri servizi IoT. Eseguire questo comando per assicurarsi di avere la versione più recente dell'estensione:

az extension add --upgrade --name azure-iot

A questo momento è possibile usare Gemelli digitali di Azure nell'interfaccia della riga di comando di Azure.

Per verificarlo, è possibile eseguire az dt --help in qualsiasi momento per visualizzare un elenco dei comandi di Gemelli digitali di Azure di primo livello disponibili.

Configurare le variabili locali per la sessione dell'interfaccia della riga di comando

Questo articolo fornisce i comandi dell'interfaccia della riga di comando che è possibile usare per creare le risorse della cronologia dei dati. Per semplificare la copia e l'esecuzione di questi comandi in un secondo momento, è possibile configurare le variabili locali nella sessione dell'interfaccia della riga di comando e quindi fare riferimento a tali variabili più avanti nei comandi dell'interfaccia della riga di comando durante la creazione delle risorse. Aggiornare i segnaposto (identificati con <...> parentesi quadre) nei comandi seguenti ed eseguire questi comandi per creare le variabili. Assicurarsi di seguire le regole di denominazione descritte nei commenti. Questi valori verranno usati in un secondo momento durante la creazione delle nuove risorse.

Nota

Questi comandi vengono scritti per l'ambiente Bash. Possono essere regolati per PowerShell se si preferisce usare un ambiente dell'interfaccia della riga di comando di PowerShell.

## General Setup
location="<your-resource-region>"
resourcegroup="<your-resource-group-name>"

## Azure Digital Twins Setup
# Instance name can contain letters, numbers, and hyphens. It must start and end with a letter or number, and be between 4 and 62 characters long.
dtname="<name-for-your-digital-twins-instance>"
# Connection name can contain letters, numbers, and hyphens. It must contain at least one letter, and be between 3 and 50 characters long.
connectionname="<name-for-your-data-history-connection>"

## Event Hub Setup
# Namespace can contain letters, numbers, and hyphens. It must start with a letter, end with a letter or number, and be between 6 and 50 characters long.
eventhubnamespace="<name-for-your-event-hub-namespace>"
# Event hub name can contain only letters, numbers, periods, hyphens and underscores. It must start and end with a letter or number.
eventhub="<name-for-your-event-hub>"

## Azure Data Explorer Setup
# Cluster name can contain only lowercase alphanumeric characters. It must start with a letter, and be between 4 and 22 characters long.
clustername="<name-for-your-cluster>"  
# Database name can contain only alphanumeric, spaces, dash and dot characters, and be up to 260 characters in length.
databasename="<name-for-your-database>"

# Enter a name for the table where relationship create and delete events will be stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events will be stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates will be stored. If not provided, the table will be named AdtPropertyEvents.
twinpropertytablename="<name-for-your-twin-property-events-table>"

Creare un'istanza di Gemelli digitali di Azure con un'identità gestita

Se si ha già un'istanza di Gemelli digitali di Azure, assicurarsi di aver abilitato un'identità gestita assegnata dal sistema.

Se non si ha un'istanza di Gemelli digitali di Azure, seguire le istruzioni riportate in Creare l'istanza con un'identità gestita per creare un'istanza di Gemelli digitali di Azure con un'identità gestita assegnata dal sistema per la prima volta.

Assicurarsi quindi di avere il ruolo proprietario dei dati di Gemelli digitali di Azure nell'istanza di . Per istruzioni, vedere Configurare le autorizzazioni di accesso utente.

Se si vuole aggiungere il nome dell'istanza alle variabili dell'interfaccia della riga di comando locale in modo che venga collegato automaticamente ai comandi successivi copiati da questo articolo, archiviarlo nella variabile dtname come segue:

dtname="<name-of-your-instance>"

Creare uno spazio dei nomi e un hub eventi di Hub eventi

Il passaggio successivo consiste nel creare uno spazio dei nomi di Hub eventi e un hub eventi. Questo hub riceverà notifiche relative al ciclo di vita del grafo e all'aggiornamento delle proprietà dall'istanza di Gemelli digitali di Azure e quindi inoltra i messaggi al cluster di Azure Esplora dati di destinazione.

Come parte della configurazione della connessione alla cronologia dati in un secondo momento, si concederà all'istanza di Gemelli digitali di Azure il ruolo di proprietario dei dati Hub eventi di Azure nella risorsa dell'hub eventi.

Per altre informazioni su Hub eventi e sulle relative funzionalità, vedere la documentazione di Hub eventi.

Nota

Durante la configurazione della cronologia dei dati, l'autorizzazione locale deve essere abilitata nell'hub eventi. Se in definitiva si vuole disabilitare l'autorizzazione locale nell'hub eventi, disabilitare l'autorizzazione dopo aver configurato la connessione. Sarà anche necessario modificare alcune autorizzazioni, descritte in Limitare l'accesso di rete alle risorse della cronologia dei dati più avanti in questo articolo.

Usare i comandi dell'interfaccia della riga di comando seguenti per creare le risorse necessarie. I comandi usano diverse variabili locali ($location, $resourcegroup, $eventhubnamespacee $eventhub) create in precedenza in Configurare le variabili locali per la sessione dell'interfaccia della riga di comando.

Creare uno spazio dei nomi di Hub eventi:

az eventhubs namespace create --name $eventhubnamespace --resource-group $resourcegroup --location $location

Creare un hub eventi nello spazio dei nomi:

az eventhubs eventhub create --name $eventhub --resource-group $resourcegroup --namespace-name $eventhubnamespace

Creare un cluster e un database Kusto (Azure Esplora dati)

Creare quindi un cluster Kusto (Azure Esplora dati) e un database per ricevere i dati da Gemelli digitali di Azure.

Come parte della configurazione della connessione alla cronologia dei dati in un secondo momento, si concederà all'istanza di Gemelli digitali di Azure il ruolo Collaboratore almeno nel database (può anche essere limitato all'ambito del cluster) e al ruolo Amministrazione nel database.

Importante

Assicurarsi che il cluster disponga dell'accesso alla rete pubblica abilitato. Se il cluster di Azure Esplora dati ha accesso alla rete pubblica disabilitato, Gemelli digitali di Azure non sarà in grado di configurare le tabelle e altri artefatti necessari e la configurazione della cronologia dei dati avrà esito negativo.

Usare i comandi dell'interfaccia della riga di comando seguenti per creare le risorse necessarie. I comandi usano diverse variabili locali ($location, $resourcegroup, $clusternamee $databasename) create in precedenza in Configurare le variabili locali per la sessione dell'interfaccia della riga di comando.

Per iniziare, aggiungere l'estensione Kusto alla sessione dell'interfaccia della riga di comando, se non è già disponibile.

az extension add --name kusto

Creare quindi il cluster Kusto. Il comando seguente richiede 5-10 minuti per l'esecuzione e creerà un cluster E2a v4 nel livello sviluppatore. Questo tipo di cluster ha un singolo nodo per il motore e il cluster di gestione dei dati ed è applicabile per scenari di sviluppo e test. Per altre informazioni sui livelli in Azure Esplora dati e su come selezionare le opzioni appropriate per il carico di lavoro di produzione, vedere Selezionare lo SKU di calcolo corretto per il cluster di Azure Esplora dati e i prezzi di Azure Esplora dati.

az kusto cluster create --cluster-name $clustername --sku name="Dev(No SLA)_Standard_E2a_v4" tier="Basic" --resource-group $resourcegroup --location $location --type SystemAssigned

Creare un database nel nuovo cluster Kusto (usando il nome del cluster precedente e nella stessa posizione). Questo database verrà usato per archiviare i dati contestualizzati di Gemelli digitali di Azure. Il comando seguente crea un database con un periodo di eliminazione temporanea di 365 giorni e un periodo di cache ad accesso frequente di 31 giorni. Per altre informazioni sulle opzioni disponibili per questo comando, vedere az kusto database create.

az kusto database create --cluster-name $clustername --database-name $databasename --resource-group $resourcegroup --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=$location

Configurare la connessione alla cronologia dati

Dopo aver creato le risorse necessarie, usare il comando in questa sezione per creare una connessione cronologia dati tra l'istanza di Gemelli digitali di Azure, l'hub eventi e il cluster di Azure Esplora dati.

Questo comando creerà anche tre tabelle nel database di Azure Esplora dati per archiviare rispettivamente gli aggiornamenti delle proprietà dei gemelli, gli eventi del ciclo di vita dei gemelli e gli eventi del ciclo di vita delle relazioni. Per altre informazioni su questi tipi di dati istorizzati e sulle tabelle di Azure Esplora dati corrispondenti, vedere Tipi di dati e schemi.

Usare il comando in questa sezione per creare una connessione alla cronologia dati e le tabelle in Azure Esplora dati. Il comando creerà sempre una tabella per gli eventi delle proprietà dei gemelli istorizzati e include parametri per creare le tabelle per gli eventi del ciclo di vita delle relazioni e del ciclo di vita dei gemelli.

Nota

Per impostazione predefinita, questo comando presuppone che tutte le risorse si trovino nello stesso gruppo di risorse dell'istanza di Gemelli digitali di Azure. È possibile specificare le risorse che si trovano in gruppi di risorse diversi usando le opzioni dei parametri per questo comando.

Il comando seguente usa le variabili locali create in precedenza in Configurare le variabili locali per la sessione dell'interfaccia della riga di comando e include diversi parametri, tra cui...

  • I nomi delle tabelle del ciclo di vita delle relazioni e del ciclo di vita dei gemelli in Azure Esplora dati (questi parametri sono facoltativi se non si vuole istorizzare questi tipi di evento, ma è necessario se si vuole istorizzare questi tipi di evento)
  • Parametro facoltativo per specificare il nome della tabella degli eventi della proprietà gemella (se questo valore non viene specificato, questa tabella verrà denominata AdtPropertyEvents per impostazione predefinita). Se non si vuole specificare un altro nome, rimuovere il --adx-property-events-table parametro dal comando prima di eseguirlo.
  • Parametro facoltativo --adx-record-removals per attivare l'istorizzazione per le eliminazioni delle proprietà gemelle (eventi che rimuovono completamente le proprietà)
az dt data-history connection create adx --dt-name $dtname --cn $connectionname --adx-cluster-name $clustername --adx-database-name $databasename --eventhub $eventhub --eventhub-namespace $eventhubnamespace --adx-property-events-table $twinpropertytablename --adx-twin-events-table $twinlifecycletablename --adx-relationship-events-table $relationshiplifecycletablename --adx-record-removals true

Quando si esegue il comando precedente, si riceverà la possibilità di assegnare le autorizzazioni necessarie per configurare la connessione alla cronologia dei dati per conto dell'utente (se sono già state assegnate le autorizzazioni necessarie, è possibile ignorare queste richieste). Queste autorizzazioni vengono concesse all'identità gestita dell'istanza di Gemelli digitali di Azure. I ruoli minimi obbligatori sono:

  • Hub eventi di Azure proprietario dei dati nell'hub eventi
  • L'ambito del collaboratore è almeno per il database specificato (può anche essere definito come ambito del cluster)
  • Assegnazione dell'entità di database con ruolo Amministrazione (per la creazione/gestione della tabella) con ambito nel database specificato

Per un'operazione regolare del piano dati, questi ruoli possono essere ridotti a un singolo ruolo mittente dati Hub eventi di Azure, se necessario.

Dopo aver configurato la connessione alla cronologia dati, è possibile rimuovere facoltativamente i ruoli concessi all'istanza di Gemelli digitali di Azure per accedere a Hub eventi e alle risorse di Azure Esplora dati. Per usare la cronologia dei dati, l'unico ruolo necessario per l'istanza è Hub eventi di Azure Mittente dati (o un ruolo superiore che include queste autorizzazioni, ad esempio Hub eventi di Azure Proprietario dati) nella risorsa hub eventi.

Nota

Dopo aver configurato la connessione, le impostazioni predefinite nel cluster di Azure Esplora dati genereranno una latenza di inserimento di circa 10 minuti o meno. È possibile ridurre questa latenza abilitando l'inserimento in streaming (meno di 10 secondi di latenza) o un criterio di inserimento in batch. Per altre informazioni sulla latenza di inserimento Esplora dati di Azure, vedere Latenza di inserimento end-to-end.

Limitare l'accesso di rete alle risorse della cronologia dei dati

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 Azure Esplora dati), è necessario impostare tali restrizioni dopo aver configurato la connessione alla cronologia dati. Ciò include la disabilitazione dell'accesso locale per le risorse, tra le altre misure per ridurre l'accesso alla rete.

Per assicurarsi che le risorse della cronologia dei dati possano comunicare tra loro, è necessario modificare anche la connessione dati per il database di Azure Esplora dati per usare un'identità gestita assegnata dal sistema.

Seguire l'ordine dei passaggi seguenti per assicurarsi che la connessione alla cronologia dei dati sia configurata correttamente quando le risorse necessitano di un accesso di rete ridotto.

  1. Assicurarsi che l'autorizzazione locale sia abilitata nelle risorse della cronologia dei dati (istanza di Gemelli digitali di Azure, hub eventi e cluster di Azure Esplora dati)
  2. Creare la connessione alla cronologia dati
  3. Aggiornare la connessione dati per il database di Azure Esplora dati per usare un'identità gestita assegnata dal sistema. Nella portale di Azure è possibile eseguire questa operazione passando al cluster Esplora dati di Azure e usando Database nel menu per passare al database della cronologia dei dati. Nel menu del database selezionare Connessioni dati. Nella voce della tabella per la connessione alla cronologia dati dovrebbe essere visualizzata l'opzione Assegna identità gestita, in cui è possibile scegliere Assegnata dal sistema. Screenshot of the option to assign a managed identity to a data connection in the Azure portal.
  4. È ora possibile disabilitare l'autorizzazione locale o impostare altre restrizioni di rete per le risorse desiderate modificando le impostazioni di accesso nell'istanza di Gemelli digitali di Azure, nell'hub eventi o nel cluster di Azure Esplora dati.

Risolvere i problemi di configurazione della connessione

Ecco alcuni errori comuni che possono verificarsi durante la configurazione di una connessione alla cronologia dati e come risolverli.

  • Se l'accesso alla rete pubblica è disabilitato per il cluster di azure Esplora dati, si verificherà un errore che indica che il servizio non è riuscito a creare la connessione alla cronologia dei dati, con il messaggio "La risorsa non è riuscita ad AGIRE a causa di un errore interno del server". L'installazione della cronologia dei dati avrà esito negativo se il cluster di Azure Esplora dati ha accesso alla rete pubblica disabilitato, perché Gemelli digitali di Azure non sarà in grado di configurare le tabelle e altri artefatti necessari.
  • (utenti dell'interfaccia della riga di comando) Se viene visualizzato l'errore "Impossibile creare una connessione all'istanza di Gemelli digitali di Azure. Non è possibile creare la tabella e la regola di mapping nel database. Controllare le autorizzazioni per Esplora database di Azure ed eseguire az login per aggiornare le credenziali", risolvere l'errore aggiungendosi come AllDatabases Amministrazione in Autorizzazioni nel cluster di Azure Esplora dati.
  • (Utenti di Cloud Shell) Se si usa Cloud Shell e viene visualizzato l'errore "Impossibile connettersi all'identità del servizio gestito. Assicurarsi che MSI sia configurato correttamente", provare a eseguire il comando con un'installazione locale dell'interfaccia della riga di comando di Azure.

Verificare con un grafico dei gemelli di esempio

Ora che la connessione alla cronologia dati è stata configurata, è possibile testarla con i dati dei gemelli digitali.

Se nell'istanza di Gemelli digitali di Azure sono già presenti gemelli che ricevono attivamente aggiornamenti del grafo (inclusi gli aggiornamenti delle proprietà gemelli o gli aggiornamenti dalla modifica della struttura del grafico creando o eliminando elementi), è possibile ignorare questa sezione e visualizzare i risultati usando le proprie risorse.

In caso contrario, continuare con questa sezione per configurare un grafico di esempio che subirà eventi del ciclo di vita di gemelli e relazioni e genera aggiornamenti delle proprietà gemelli.

È possibile configurare un grafico di esempio per questo scenario usando il simulatore di dati di Gemelli digitali di Azure. Il simulatore di dati di Gemelli digitali di Azure crea gemelli e relazioni nell'istanza di Gemelli digitali di Azure e inserisce continuamente gli aggiornamenti delle proprietà nei gemelli.

Creare un grafico di esempio

È possibile usare il simulatore di dati di Gemelli digitali di Azure per effettuare il provisioning di un grafo di gemelli di esempio e di eseguire il push degli aggiornamenti delle proprietà. Il grafo gemello creato qui modella i processi di normalizzazione per un'azienda lattiero-casearia.

Per iniziare, aprire il simulatore di dati di Gemelli digitali di Azure nel browser. Impostare i campi seguenti:

  • URL istanza: immettere il nome host dell'istanza di Gemelli digitali di Azure. Il nome host è disponibile nella pagina del portale per l'istanza e ha un formato simile a <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.net.
  • Tipo di simulazione: selezionare Struttura lattiero-casearia dal menu a discesa.

Selezionare Genera ambiente.

Screenshot of the Azure Digital Twins Data simulator.

Verranno visualizzati messaggi di conferma sullo schermo come modelli, gemelli e relazioni vengono creati nell'ambiente in uso. Verranno generati anche eventi di creazione di relazioni e gemelli, che verranno istorizzati in Azure Esplora dati rispettivamente come eventi del ciclo di vita dei gemelli e delle relazioni.

Quando la simulazione è pronta, il pulsante Avvia simulazione diventerà abilitato. Scorrere verso il basso e selezionare Avvia simulazione per eseguire il push dei dati simulati nell'istanza di Gemelli digitali di Azure. Per aggiornare continuamente i gemelli nell'istanza di Gemelli digitali di Azure, mantenere in primo piano questa finestra del browser sul desktop e completare altre azioni del browser in una finestra separata. In questo modo verranno generati continuamente eventi di aggiornamento delle proprietà gemelli che verranno istorizzati in Azure Esplora dati.

Visualizzare gli aggiornamenti istorizzati in Azure Esplora dati

Questa sezione illustra come visualizzare tutti e tre i tipi di aggiornamenti istorizzati generati dal simulatore e archiviati nelle tabelle di Azure Esplora dati.

Iniziare nella portale di Azure e passare al cluster Esplora dati di Azure creato in precedenza. Scegliere il riquadro Database dal menu a sinistra per aprire la visualizzazione database. Trovare il database creato per questo articolo e selezionare la casella di controllo accanto, quindi selezionare Query.

Screenshot of the Azure portal showing a database in an Azure Data Explorer cluster.

Espandere quindi il cluster e il database nel riquadro sinistro per visualizzare il nome delle tabelle della cronologia dei dati. Dovrebbero essere presenti tre eventi: uno per gli eventi del ciclo di vita delle relazioni, uno per gli eventi del ciclo di vita dei gemelli e uno per gli eventi di aggiornamento delle proprietà gemelle. Questi nomi di tabella verranno usati per eseguire query sulle tabelle per verificare e visualizzare i dati istorizzati.

Screenshot of the Azure portal showing the query view for the database. The name of the data history table is highlighted.

Verificare le voci della tabella

Per verificare che gli eventi vengano istorizzati nel database, iniziare copiando il comando seguente. Ha un segnaposto per il nome della tabella degli eventi del ciclo di vita delle relazioni e cambierà l'inserimento per la tabella in modalità batch in modo da inserire i dati dalla simulazione in tempo reale ogni 10 secondi.

.alter table <relationship-lifecycle-events-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

Incollare il comando nella finestra di query, sostituendo il segnaposto con il nome della tabella degli eventi della relazione. Selezionare il pulsante Esegui per eseguire il comando.

Screenshot of the Azure portal showing the query view for the database. The Run button is highlighted.

Ripetere il comando altre due volte usando il nome della tabella degli eventi del ciclo di vita dei gemelli e quindi la tabella di aggiornamento delle proprietà per aggiornare anche la modalità di inserimento delle altre tabelle.

Aggiungere quindi i comandi seguenti alla finestra di query ed eseguirli. Ogni comando contiene un segnaposto per il nome di una delle tabelle e i comandi restituiranno il numero di elementi nelle tabelle.

Nota

La visualizzazione del primo batch di dati inseriti può richiedere fino a 5 minuti.

<relationship-lifecycle-events-table-name>
| count

<twin-lifecycle-events-table-name>
| count

<twin-property-updates-table-name>
| count

Nei risultati si noterà che il numero di elementi in ogni tabella è maggiore di 0, a indicare che gli eventi relativi al ciclo di vita delle relazioni, al ciclo di vita dei gemelli e agli eventi di aggiornamento delle proprietà vengono istorizzati nelle rispettive tabelle.

Esplorare la tabella degli aggiornamenti delle proprietà dei dispositivi gemelli

In questa sezione verranno eseguite altre operazioni di esplorazione con i dati di aggiornamento delle proprietà gemelle presenti nella tabella.

Eseguire prima di tutto il comando seguente per visualizzare 100 record nella tabella:

<twin-property-updates-table-name>
| limit 100

Eseguire quindi una query in base ai dati dei gemelli per visualizzare i dati delle serie temporali contestualizzate.

Usare la query seguente per tracciare il flusso di uscita di tutti i gemelli di macchine salt nella fabbrica lattiero-casearia di Oslo di esempio. Questa query Kusto usa il plug-in Gemelli digitali di Azure per selezionare i gemelli di interesse, unisce tali gemelli alla serie temporale della cronologia dei dati in Azure Esplora dati e quindi grafici i risultati. Assicurarsi di sostituire il <ADT-instance-host-name> segnaposto con il nome host dell'istanza e il <table-name> segnaposto con il nome della tabella degli eventi della proprietà gemella.

let ADTendpoint = "https://<ADT-instance-host-name>";
let ADTquery = ```SELECT SALT_MACHINE.$dtId as tid
FROM DIGITALTWINS FACTORY 
JOIN SALT_MACHINE RELATED FACTORY.contains 
WHERE FACTORY.$dtId = 'OsloFactory'
AND IS_OF_MODEL(SALT_MACHINE , 'dtmi:assetGen:SaltMachine;1')```;
evaluate azure_digital_twins_query_request(ADTendpoint, ADTquery)
| extend Id = tostring(tid)
| join kind=inner (<table-name>) on Id
| extend val_double = todouble(Value)
| where Key == "OutFlow"
| render timechart with (ycolumns = val_double)

I risultati dovrebbero mostrare i numeri di uscita che cambiano nel tempo.

Screenshot of the Azure portal showing the query view for the database.

Risoluzione dei problemi di connessione

Se i dati in Azure Esplora dati non vengono visualizzati, il flusso di dati di istorizzazione non funziona correttamente. È possibile analizzare il problema visualizzando lo spazio dei nomi di Hub eventi nella portale di Azure, che visualizza i grafici che mostrano il flusso dei messaggi all'interno e all'esterno dello spazio dei nomi. In questo modo sarà possibile verificare sia il flusso dei messaggi in ingresso da Gemelli digitali di Azure che i messaggi in uscita ad Azure Esplora dati, per identificare quale parte del flusso non funziona.

Screenshot of the Azure portal showing an Event Hubs namespace for the simulated environment.

Passaggi successivi

Per continuare a esplorare lo scenario lattiero-caseario, è possibile visualizzare più query di esempio su GitHub che illustrano come monitorare le prestazioni dell'operazione lattiero-casearia in base al tipo di macchina, alla fabbrica, al tecnico di manutenzione e a varie combinazioni di questi parametri.

Per creare dashboard di Grafana che visualizzano le prestazioni dell'operazione lattiero-casearia, vedere Creazione di dashboard con Gemelli digitali di Azure, Azure Esplora dati e Grafana.

Per altre informazioni sull'uso del plug-in di query di Gemelli digitali di Azure per Azure Esplora dati, vedere Esecuzione di query con il plug-in azure Esplora dati e questo post di blog. Altre informazioni sul plug-in sono disponibili qui: Esecuzione di query con il plug-in azure Esplora dati.