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 grafico dei gemelli 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 hub IoT con molte funzionalità confrontabili.

Per esempi più dettagliati di sintassi di query e come eseguire richieste di query, vedere Eseguire query sul grafico dei gemelli.

Informazioni sulle query

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

• 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 collegamenti 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.

• Caratteri di escape tra virgolette singole: se il testo della query include un carattere di virgolette singole nei dati, sarà necessario usare un carattere di escape con il \ carattere . Ecco un esempio che riguarda il valore della proprietà D'Souza:

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

Nota

Dopo aver apportato una modifica ai dati nel grafico, potrebbe verificarsi una latenza 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 gemelli istorizzati nel tempo

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

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

Passaggi successivi

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