azure_digital_twins_query_request, plug-in

Le azure_digital_twins_query_request plug-in exécute une requête Azure Digital Twins dans le cadre d’une requête Langage de requête Kusto (KQL). Le plug-in est appelé avec l’opérateur evaluate .

À l’aide du plug-in, vous pouvez interroger des données dans Azure Digital Twins et toute source de données accessible via KQL. Par exemple, vous pouvez effectuer des analyses de série chronologique.

Pour plus d’informations sur le plug-in, consultez le plug-in de requête Azure Digital Twins pour Azure Data Explorer.

Syntaxe

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
AdtInstanceEndpoint	string	✔️	Point de terminaison de l’instance Azure Digital Twins à interroger.
AdtQuery	string	✔️	Requête à exécuter sur le point de terminaison Azure Digital Twins. Cette requête est écrite dans un langage de requête de type SQL personnalisé pour Azure Digital Twins, appelé langage de requête Azure Digital Twins. Pour plus d’informations, consultez le langage de requête pour Azure Digital Twins.

Authentification et autorisation

Le azure_digital_twins_query_request plug-in utilise le compte Microsoft Entra de l’utilisateur exécutant la requête pour s’authentifier. Pour exécuter une requête, un utilisateur doit au moins disposer du rôle Lecteur de données Azure Digital Twins. Vous trouverez des informations sur la façon d’attribuer ce rôle dans Sécurité pour les solutions Azure Digital Twins.

Exemples

Les exemples suivants montrent comment exécuter différentes requêtes Azure Digital Twins, y compris les requêtes qui utilisent des expressions Kusto supplémentaires.

Récupération de tous les jumeaux dans une instance Azure Digital Twins

L’exemple suivant retourne tous les jumeaux numériques au sein d’une instance Azure Digital Twins.

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

Projection de propriétés de jumeau sous forme de colonnes, ainsi que d’expressions Kusto supplémentaires

L’exemple suivant retourne le résultat du plug-in sous forme de colonnes distinctes, puis effectue des opérations supplémentaires à l’aide d’expressions 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

Sortie

TemperatureInC	Humidité
21	48
49	34
80	32

Effectuer des analyses de série chronologique

Vous pouvez utiliser la fonctionnalité d’intégration de l’historique des données d’Azure Digital Twins pour historiser les mises à jour des propriétés de jumeau numérique. Pour savoir comment afficher les mises à jour de jumeau historisés, consultez Afficher les mises à jour des jumeaux historisés dans Azure Data Explorer