FROM - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die FROM Klausel identifiziert die Datenquelle für eine Abfrage.

Syntax

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

	Description
from_source	Gibt eine Datenquelle mit oder ohne Alias an.
AS input_alias	Gibt an, dass die input_alias eine Gruppe von Werten ist, die vom zugrunde liegenden Containerausdruck zurückgegeben werden.
input_alias IN	Gibt an, dass die input_alias den Satz von Werten darstellen soll, die durch Durchlaufen aller Arrayelemente jedes Arrays, das vom zugrunde liegenden Containerausdruck zurückgegeben wird, abgerufen werden.
container_expression	Gibt den Containerausdruck an, der zum Abrufen der Elemente verwendet werden soll.
ROOT	Gibt an, dass das Element aus dem Standardcontainer abgerufen werden soll, der aktuell verbunden ist.
container_name	Gibt an, dass das Element aus dem bereitgestellten Container abgerufen werden soll.
input_alias	Gibt an, dass das Element aus der anderen vom bereitgestellten Alias definierten Quelle abgerufen werden soll.
<container_expression> '.' property_name	Gibt an, dass das Element abgerufen werden soll, indem auf die eigenschaft property_name zugegriffen wird.
<container_expression> '[' "property_name" | array_index ']'	Gibt an, dass das Element abgerufen werden soll, indem auf die property_name Eigenschaft oder array_index Arrayelement für alle Elemente zugegriffen werden soll, die vom angegebenen Containerausdruck abgerufen werden.

Rückgabetypen

Gibt den Satz von Elementen aus der angegebenen Quelle zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

FROM-Klausel mit Containeralias

In diesem Beispiel wird die FROM Klausel verwendet, um den aktuellen Container als Quelle anzugeben, ihm einen eindeutigen Namen zu geben und ihn dann als Alias anzugeben. Der Alias wird dann verwendet, um bestimmte Felder in den Abfrageergebnissen zu projizieren.

SELECT VALUE 
  p.name
FROM
  products p

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

FROM-Klausel mit Subroot als Quelle

In diesem Beispiel kann die Klausel auch die FROM Quelle auf eine kleinere Teilmenge reduzieren. Um nur eine Unterstruktur in jedem Element aufzählen zu können, kann die Unterwurzel zur Quelle werden. Ein Array- oder Objektunterstamm kann als Quelle verwendet werden.

SELECT VALUE
  s
FROM
  products.sizes s

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

Bemerkungen

• Alle aliase, die in den <from_source>(s) bereitgestellten oder abgeleiteten Aliasen angegeben oder abgeleitet werden, müssen eindeutig sein.
• Wenn ein Containerausdruck auf Eigenschaften oder Arrayelemente zugreift und dieser Wert nicht vorhanden ist, wird dieser Wert ignoriert und nicht weiter verarbeitet.
• Ein Containerausdruck kann containerbereichs- oder Elementbereich sein.
• Ein Ausdruck ist containerbereichsbezogenen, wenn die zugrunde liegende Quelle des Containerausdrucks entweder ROOT oder container_name. Ein solcher Ausdruck stellt eine Gruppe von Elementen dar, die direkt aus dem Container abgerufen werden, und ist nicht von der Verarbeitung anderer Containerausdrücke abhängig.
• Ein Ausdruck ist elementbereichsbezogener Ausdruck, wenn die zugrunde liegende Quelle des Containerausdrucks weiter oben in der Abfrage eingeführt wird input_alias . Ein solcher Ausdruck stellt eine Reihe von Elementen dar, die durch die Auswertung des Containerausdrucks abgerufen werden. Diese Auswertung wird im Bereich der einzelnen Elemente ausgeführt, die dem mit dem aliasierten Container verknüpften Satz gehören. Der resultierende Satz ist eine Vereinigung von Sätzen, die durch Auswerten des Containerausdrucks für die einzelnen Elemente im zugrunde liegenden Satz abgerufen werden.