azure_digital_twins_query_request plugin

Articolo
11/23/2024

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

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

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

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

Sintassi

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
AdtInstanceEndpoint	`string`	✔️	Endpoint dell'istanza di Gemelli digitali di Azure su cui eseguire query.
AdtQuery	`string`	✔️	Query da eseguire sull'endpoint di Gemelli digitali di Azure. Questa query viene scritta in un linguaggio di query simile a 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, a un utente deve essere concesso almeno il ruolo lettore dati di Gemelli digitali di Azure. Per informazioni su come assegnare questo ruolo, vedere Security for Azure Digital Twins solutions (Sicurezza per soluzioni di Gemelli digitali di Azure).

Esempi

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

L'esempio seguente restituisce 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')

Screenshot dei gemelli presenti nell'istanza di Gemelli digitali di Azure.

Proiezione di proprietà dei dispositivi gemelli come colonne e espressioni Kusto aggiuntive

L'esempio seguente restituisce il risultato del 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 l'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à dei gemelli digitali. Per informazioni su come visualizzare gli aggiornamenti dei gemelli istorizzati, vedere Visualizzare gli aggiornamenti dei gemelli istorizzati

Condividi tramite