Linguaggio di query di Gemelli digitali di Azure

Questo articolo descrive le nozioni di base del linguaggio di query e le relative funzionalità. Tenere presente che il centro di Gemelli digitali di Azure è il grafo dei gemelli, costruito da gemelli digitali e relazioni. È possibile eseguire query sul grafo per ottenere informazioni sui gemelli digitali e sulle relazioni in esso contenute. Queste query vengono scritte in un linguaggio di query di tipo SQL personalizzato, chiamato linguaggio di query di Gemelli digitali di Azure. Questo linguaggio è simile al linguaggio di query di hub IoT con molte funzionalità confrontabili.

Per esempi più dettagliati della sintassi delle query e per l'esecuzione di richieste di query, vedere Eseguire query sul grafo dei gemelli.

Informazioni sulle query

È possibile usare il linguaggio di query di Gemelli digitali di Azure per recuperare i gemelli digitali in base al relativo...

• Proprietà (incluse le proprietà dei tag)
• Modelli
• Relazioni
  • Proprietà delle relazioni

Per inviare una query al servizio da un'app client, si userà l'API query di Gemelli digitali di Azure. Un modo per usare l'API consiste nell'usare uno degli SDK per Gemelli digitali di Azure.

Documentazione di riferimento

Le informazioni di riferimento sul linguaggio di query sono disponibili in Informazioni di riferimento nel sommario a sinistra per la documentazione di Gemelli digitali di Azure. È anche possibile passare direttamente alle sezioni di riferimento usando i link seguenti:

• Clausole
  • SELECT
  • FROM
  • MATCH
  • JOIN
  • WHERE
• Funzioni
• Operatori
• Parole chiave riservate

Considerazioni per l'esecuzione di query

Quando si scrivono query per Gemelli digitali di Azure, tenere presenti le considerazioni seguenti:

• Ricordarsi della distinzione tra maiuscole e minuscole: tutte le operazioni di query di Gemelli digitali di Azure fanno distinzione tra maiuscole e minuscole, quindi prestare attenzione all'uso dei nomi esatti definiti nei modelli. Se i nomi delle proprietà vengono digitati in modo errato o con la combinazione di maiuscole/minuscole sbagliata, il set di risultati è vuoto e non verranno restituiti errori.

• Virgolette singole di escape: se il testo della query include un singolo carattere di virgolette nei dati, è necessario che la virgoletta venga preceduta da un carattere di escape con il carattere \. Ecco un esempio che gestisce un valore di proprietà di D'Souza:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

Nota

Dopo aver apportato una modifica ai dati nel grafo, potrebbe verificarsi una latenza di fino a 10 secondi prima che le modifiche vengano riflesse nelle query.

L'API DigitalTwins riflette immediatamente le modifiche, quindi se è necessaria una risposta immediata, usare una richiesta API (DigitalTwins GetById) o una chiamata SDK (GetDigitalTwin) per ottenere dati gemelli anziché una query.

Esecuzione di query sui dati dei gemelli storicizzati nel tempo

Il linguaggio di query di Gemelli digitali di Azure è solo per eseguire query sullo stato attuale dei gemelli digitali e delle relazioni.

Per eseguire query sui dati del grafo dei gemelli storicizzati raccolti nel tempo, usare la funzionalità cronologia dei dati per connettere l'istanza di Gemelli digitali di Azure a un cluster di Esplora dati di Azure. In questo modo gli aggiornamenti del grafo verranno automaticamente eseguiti in Esplora dati di Azure, in cui è possibile eseguire query usando il plug-in Gemelli digitali di Azure per Esplora dati di Azure.

Passaggi successivi

Informazioni su come scrivere query e vedere esempi di codice client in Eseguire query sul grafo dei gemelli.