Informations de référence sur le langage de requête Azure Digital Twins : clause FROM

  • Article

Ce document contient des informations de référence sur la clause FROM du langage de requête Azure Digital Twins.

La clause FROM est la deuxième partie d’une requête. Elle spécifie la collection et toutes les jointures sur lesquelles la requête agira.

Cette clause est obligatoire pour toutes les requêtes.

SELECT ... FROM DIGITALTWINS

Utilisez FROM DIGITALTWINS (non sensible à la casse) pour faire référence à l’ensemble de la collection de jumeaux numériques dans une instance.

Vous pouvez éventuellement ajouter un nom à la collection de jumeaux numériques en ajoutant le nom à la fin de l’instruction.

Syntaxe

De base :

--SELECT ...
FROM DIGITALTWINS

Pour nommer la collection :

--SELECT ...
FROM DIGITALTWINS <collection-name>

Exemples

Voici une requête de base. La requête suivante renvoie tous les jumeaux numériques de l’instance.

SELECT *
FROM DIGITALTWINS

Voici une requête avec une collection nommée. La requête suivante attribue un nom T à la collection et renvoie toujours tous les jumeaux numériques de l’instance.

SELECT *
FROM DIGITALTWINS T

SELECT ... FROM RELATIONSHIPS

Utilisez FROM RELATIONSHIPS (non sensible à la casse) pour faire référence à l’ensemble de la collection de relations dans une instance.

Vous pouvez éventuellement ajouter un nom à la collection de relations en ajoutant le nom à la fin de l’instruction.

Notes

Cette fonctionnalité ne peut pas être combinée avec JOIN.

Syntaxe

De base :

--SELECT ...
FROM RELATIONSHIPS

Pour nommer la collection :

--SELECT ...
FROM RELATIONSHIPS <collection-name>

Exemples

Voici une requête qui retourne toutes les relations de l’instance.

SELECT *
FROM RELATIONSHIPS

Voici une requête qui retourne toutes les relations provenant des jumeaux A, B, C ou D.

SELECT *
FROM RELATIONSHIPS
WHERE $sourceId IN  ['A', 'B', 'C', 'D']

Utilisation conjointe de FROM et JOIN

La clause FROM peut être combinée avec la clause JOIN pour exprimer des traversées entre entités dans le graphique Azure Digital Twins.

Pour plus d’informations sur la clause JOIN et les requêtes de traversées du graphique, consultez Informations de référence sur le langage de requête Azure Digital Twins : clause JOIN.

Limites

Les limites suivantes s’appliquent aux requêtes utilisant FROM.

Pour plus d’informations, consultez les sections suivantes.

Aucune sous-requête

Aucune sous-requête n’est prise en charge dans l’instruction FROM.

Exemple (négatif)

La requête suivante montre un exemple de ce qui ne peut pas être fait selon cette limitation.

SELECT * 
FROM (SELECT * FROM DIGITALTWINS T WHERE ...)

Choisir FROM RELATIONSHIPS ou JOIN

La fonctionnalité FROM RELATIONSHIPS ne peut pas être combinée avec JOIN. Vous devez choisir celle de ces options qui convient le mieux aux informations que vous souhaitez sélectionner.