FROM – Frågespråk i Cosmos DB (i Azure och Fabric)

Satsen FROM identifierar datakällan för en fråga.

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	Anger en datakälla, med eller utan ett alias.
AS input_alias	Anger att input_alias är en uppsättning värden som returneras av det underliggande containeruttrycket.
input_alias IN	Anger att input_alias ska representera den uppsättning värden som erhålls genom iterering över alla matriselement i varje matris som returneras av det underliggande containeruttrycket.
container_expression	Anger det containeruttryck som ska användas för att hämta objekten.
ROOT	Anger att objektet ska hämtas från den för närvarande anslutna standardcontainern.
container_name	Anger att objektet ska hämtas från den angivna containern.
input_alias	Anger att objektet ska hämtas från den andra källan som definieras av det angivna aliaset.
<container_expression> '.' property_name	Anger att objektet ska hämtas genom åtkomst till egenskapen property_name.
<container_expression> '[' "property_name" | array_index ']'	Anger att objektet ska hämtas genom att komma åt egenskapen property_name eller array_index matriselement för alla objekt som hämtas av det angivna containeruttrycket.

Returtyper

Returnerar uppsättningen med objekt från den angivna källan.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

FROM-sats med containeralias

I det här exemplet FROM används -satsen för att ange den aktuella containern som en källa, ge den ett unikt namn och sedan alias det. Aliaset används sedan för att projicera specifika fält i frågeresultatet.

SELECT VALUE 
  p.name
FROM
  products p

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

FROM-sats med subroot som källa

I det här exemplet FROM kan satsen också minska källan till en mindre delmängd. Om du bara vill räkna upp ett underträd i varje objekt kan underroten bli källan. En matris eller objektunderrot kan användas som källa.

SELECT VALUE
  s
FROM
  products.sizes s

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

Anmärkningar

• Alla alias som anges eller härleds i <from_source>(s) måste vara unika.
• Om ett containeruttryck kommer åt egenskaper eller matriselement och det värdet inte finns ignoreras det värdet och bearbetas inte ytterligare.
• Ett containeruttryck kan vara containeromfång eller objektomfång.
• Ett uttryck är containeromfång, om den underliggande källan för containeruttrycket är antingen ROOT eller container_name. Ett sådant uttryck representerar en uppsättning objekt som hämtats direkt från containern och är inte beroende av bearbetningen av andra containeruttryck.
• Ett uttryck är objektomfångat, om den underliggande källan för containeruttrycket input_alias introduceras tidigare i frågan. Ett sådant uttryck representerar en uppsättning objekt som hämtas genom att utvärdera containeruttrycket. Den här utvärderingen utförs i omfånget för varje objekt som tillhör uppsättningen som är associerad med den aliaserade containern. Den resulterande uppsättningen är en union av uppsättningar som hämtas genom att utvärdera containeruttrycket för vart och ett av objekten i den underliggande uppsättningen.