Langage des requêtes Azure Digital Twins

Cet article décrit les principes fondamentaux du langage de requête et de ses fonctionnalités. N’oubliez pas que le centre d’Azure Digital Twins est le graphe de jumeaux construit à partir des jumeaux numériques et des relations. Ce graphique peut être interrogé pour obtenir des informations sur les jumeaux numériques et les relations qu’il contient. Ces requêtes sont écrites dans un langage de requête de type SQL personnalisé, appelé langage des requêtes Azure Digital Twins. Ce langage est similaire au langage de requête IoT Hub par ses nombreuses fonctionnalités comparables.

Pour obtenir des exemples plus détaillés de syntaxe de requête et savoir comment exécuter des requêtes, consultez Interroger le graphique de jumeaux.

À propos des requêtes

Vous pouvez utiliser le langage de requête Azure Digital Twins pour récupérer des jumeaux numériques en fonction de leurs...

• Propriétés (notamment propriétés de balise)
• Modèles
• Relations
  • Propriétés des relations

Pour soumettre une requête au service à partir d’une application cliente, vous utilisez l’API de requête Azure Digital Twins. L’une des façons d’utiliser l’API consiste à utiliser l’un des kits SDK pour Azure Digital Twins.

Documentation de référence

Les informations de référence sur le langage de requête se trouvent sous Informations de référence dans la table des matières de gauche de la documentation Azure Digital Twins. Vous pouvez également accéder directement aux sections de référence en utilisant les liens ci-dessous :

• Clauses
  • SELECT
  • FROM
  • MATCH
  • JOIN
  • WHERE
• Fonctions
• Opérateurs
• Mots clés réservés

Considérations liées à l’interrogation

Quand vous écrivez des requêtes pour Azure Digital Twins, gardez à l’esprit les points suivants :

• Penser au respect de la casse : toutes les opérations de requête Azure Digital Twins sont sensibles à la casse. Veillez donc à utiliser les noms exacts définis dans les modèles. Si les noms des propriétés sont mal orthographiés ou ne respectent pas la casse, le jeu de résultats sera vide et aucune erreur ne sera retournée.

• Placez les guillemets simples dans une séquence d’échappement : si le texte de votre requête comprend un caractère guillemet simple dans les données, le guillemet doit être placé dans une séquence d’échappement avec le caractère \. Voici un exemple qui traite une valeur de propriété D'Souza :

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

Notes

Vous pouvez constater une latence jusqu’à 10 secondes pour que les changements que vous apportez aux données de votre graphe prennent effet dans les requêtes.

L’API DigitalTwins reflète les changements tout de suite, donc si vous avez besoin d’une réponse instantanée, utilisez une demande d’API DigitalTwins GetById ou un appel de SDK (GetDigitalTwin) pour obtenir des données de jumeau au lieu d’une requête.

Interrogation des données d’historique des jumeaux

Le langage de requête Azure Digital Twins est destiné uniquement à l’interrogation de l’état actuel de vos jumeaux numériques et de leurs relations.

Pour exécuter des requêtes sur des données de graphe de jumeaux historisées collectées au fil du temps, utilisez la fonctionnalité d’historique des données pour connecter votre instance Azure Digital Twins à un cluster Azure Data Explorer. Cela historise automatiquement les mises à jour de graphiques vers Azure Data Explorer, où elles peuvent être interrogées à l’aide du plug-in Azure Digital Twins pour Azure Data Explorer.

Étapes suivantes

Apprenez à écrire des requêtes et examinez des exemples de codes clients dans Interroger le graphe de jumeaux.