plug-in azure_digital_twins_query_request

Il azure_digital_twins_query_request plug-in esegue una query di Gemelli digitali di Azure come parte di una query Linguaggio di query Kusto (KQL). Il plug-in viene richiamato con l'operatore evaluate .

Usando il plug-in è possibile eseguire query su dati in Gemelli digitali di Azure e in qualsiasi origine dati accessibile tramite KQL. Ad esempio, è possibile eseguire l'analisi delle serie temporali.

Per altre informazioni sul plug-in, vedere Plug-in query di Gemelli digitali di Azure per Azure Esplora dati.

Sintassi

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Tipo	Obbligatoria	Descrizione
AdtInstanceEndpoint	string	✔️	Endpoint dell'istanza di Gemelli digitali di Azure da eseguire una query.
AdtQuery	string	✔️	Query da eseguire sull'endpoint gemelli digitali di Azure. Questa query viene scritta in un linguaggio di query SQL personalizzato per Gemelli digitali di Azure, denominato linguaggio di query di Gemelli digitali di Azure. Per altre informazioni, vedere Linguaggio di query per Gemelli digitali di Azure.

Autenticazione e autorizzazione

Il azure_digital_twins_query_request plug-in usa l'account Microsoft Entra dell'utente che esegue la query per l'autenticazione. Per eseguire una query, un utente deve avere almeno il ruolo lettore dati di Gemelli digitali di Azure . Informazioni su come assegnare questo ruolo sono disponibili nelle soluzioni Security for Digital Twins di Azure.

Esempio

Gli esempi seguenti illustrano come eseguire varie query di Gemelli digitali di Azure, incluse le query che usano espressioni Kusto aggiuntive.

Recupero di tutti i gemelli all'interno di un'istanza di Gemelli digitali di Azure

Nell'esempio seguente vengono restituiti tutti i gemelli digitali all'interno di un'istanza di Gemelli digitali di Azure.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Proiezione delle proprietà gemelle come colonne insieme a espressioni Kusto aggiuntive

L'esempio seguente restituisce il risultato dal plug-in come colonne separate e quindi esegue operazioni aggiuntive usando espressioni Kusto.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Output

TemperatureInC	Umidità
21	48
49	34
80	32

Eseguire analisi delle serie temporali

È possibile usare la funzionalità di integrazione della cronologia dei dati di Gemelli digitali di Azure per istorizzare gli aggiornamenti delle proprietà di gemelli digitali. Per informazioni su come visualizzare gli aggiornamenti dei gemelli istorizzati, vedere Visualizzare gli aggiornamenti dei gemelli istorizzati in Azure Esplora dati