FROM - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La FROM clause identifie la source de données d’une requête.

Syntaxe

FROM <from_specification>

<from_specification> ::= <from_source> {[ JOIN <from_source>][,...n]}
<from_source> ::= <container_expression> [[AS] input_alias] | input_alias IN <container_expression>
<container_expression> ::= ROOT | container_name | input_alias | <container_expression> '.' property_name | <container_expression> '[' "property_name" | array_index ']'

Arguments

	Descriptif
from_source	Spécifie une source de données, avec ou sans alias.
AS input_alias	Spécifie que le input_alias est un ensemble de valeurs retournées par l’expression conteneur sous-jacente.
input_alias IN	Spécifie que le input_alias doit représenter l’ensemble de valeurs obtenues en itérant sur tous les éléments de tableau de chaque tableau retourné par l’expression conteneur sous-jacente.
container_expression	Spécifie l’expression conteneur à utiliser pour récupérer les éléments.
ROOT	Spécifie que l’élément doit être récupéré à partir du conteneur par défaut actuellement connecté.
container_name	Spécifie que l’élément doit être récupéré à partir du conteneur fourni.
input_alias	Spécifie que l’élément doit être récupéré à partir de l’autre source définie par l’alias fourni.
<container_expression> '.' property_name	Spécifie que l’élément doit être récupéré en accédant à la propriété property_name.
<container_expression> '[' "property_name" | array_index ']'	Spécifie que l’élément doit être récupéré en accédant à la propriété property_name ou array_index élément de tableau pour tous les éléments récupérés par l’expression conteneur spécifiée.

Types de retour

Retourne l’ensemble d’éléments de la source spécifiée.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Clause FROM avec alias de conteneur

Dans cet exemple, la FROM clause est utilisée pour spécifier le conteneur actuel en tant que source, lui attribuer un nom unique, puis l’alias. L’alias est ensuite utilisé pour projeter des champs spécifiques dans les résultats de la requête.

SELECT VALUE 
  p.name
FROM
  products p

[
  "Joller Kid's Jacket",
  "Codlier Kid's Jacket",
  ...
]

Clause FROM avec sous-racine en tant que source

Dans cet exemple, la FROM clause peut également réduire la source à un sous-ensemble plus petit. Pour énumérer uniquement une sous-arborescence dans chaque élément, la sous-racine peut devenir la source. Un tableau ou une sous-racine d’objet peut être utilisé comme source.

SELECT VALUE
  s
FROM
  products.sizes s

[
  {
    "key": "65",
    "description": "6.5",
    "order": 0
  },
  {
    "key": "75",
    "description": "7.5",
    "order": 1
  },
  ...
]

Remarques

• Tous les alias fournis ou déduits dans les <from_source>(s) doivent être uniques.
• Si une expression conteneur accède aux propriétés ou aux éléments de tableau et que cette valeur n’existe pas, cette valeur est ignorée et n’est pas traitée plus loin.
• Une expression conteneur peut être délimitée par un conteneur ou une étendue d’élément.
• Une expression est délimitée par un conteneur, si la source sous-jacente de l’expression conteneur est l’une ou l’autre ROOTcontainer_name. Cette expression représente un ensemble d’éléments récupérés directement à partir du conteneur et ne dépend pas du traitement d’autres expressions de conteneur.
• Une expression est délimitée à l’élément, si la source sous-jacente de l’expression conteneur est input_alias introduite précédemment dans la requête. Une telle expression représente un ensemble d’éléments obtenus en évaluant l’expression conteneur. Cette évaluation est effectuée dans l’étendue de chaque élément appartenant au jeu associé au conteneur alias. Le jeu obtenu est une union de jeux obtenus en évaluant l’expression conteneur pour chacun des éléments du jeu sous-jacent.