Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
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.
Syntaxe
evaluate
azure_digital_twins_query_request
(
AdtInstanceEndpoint,AdtQuery)
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Catégorie | Requise | Descriptif |
|---|---|---|---|
| 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
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')
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é |
|---|---|
| Vingt-et-un | 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 des jumeaux historisés, consultez Afficher les mises à jour des jumeaux historisés