FROM 句 (NoSQL クエリ)

適用対象: NoSQL

ソースがクエリの後半でフィルター処理またはプロジェクションされる場合を除いて、FROM (FROM <from_specification>) 句はオプションです。 SELECT * FROM products のようなクエリでは、名前に関係なくコンテナー全体が列挙されます。 コンテナー名の代わりにコンテナーに特別な識別子 ROOT を使うこともできます。

FROM 句では、クエリごとに次の規則が適用されます。

• コンテナーは、SELECT p.id FROM products AS p またはシンプルに SELECT p.id FROM products p のようにエイリアス化することができます。 ここで p はコンテナーの別名です。 コンテナーには、必ずしも products または p という名前を付ける必要はありません。 AS は識別子に別名を付けるためのオプションのキーワードです。
• 別名を付けると、元のソース名をバインドすることはできなくなります。 たとえば、SELECT products.id FROM products p は無効な構文となります。識別子 products がエイリアス化されており、それ以上解決できないためです。
• 参照されているすべてのプロパティを完全修飾し、厳格なスキーマの準拠がない場合の曖昧なバインドを回避する必要があります。 たとえば、プロパティ id がバインドされていないため、SELECT id FROM products p は無効な構文です。 クエリでは、代わりに p.id (または <alias>.<property-name>) を使用して、プロパティ id を参照する必要があります。

構文

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 ']'

引数

解説

指定されるか <from_source> で推測されたすべての別名は一意である必要があります。 <container_expression> '.' property_name 構文は、<container_expression> '[' "property_name" ']' と同じです。 ただし、プロパティ名に非識別子文字が含まれている場合は、後者の構文を使用できます。

見つからないプロパティ、見つからない配列要素、未定義の値の処理

コンテナー式でプロパティまたは配列要素にアクセスし、その値が存在しない場合、値は無視され、処理は行われません。

コンテナー式のコンテキストのスコープ

コンテナー式には、コンテナー スコープまたは項目スコープがあります。

• 基になるコンテナー式のソースが ROOT または container_name である場合、式はコンテナー スコープです。 このような式は、直接コンテナーから取得された項目のセットを表し、その他のコンテナーの式の処理に依存しません。

• 基になるコンテナー式のソースが、クエリで前に導入された input_alias である場合、式は項目スコープです。 このような式は、コンテナー式を評価することによって取得された項目のセットを表します。 この評価は、別名を付けられたコンテナーに関連付けられているセットに属する各項目のスコープ内で実行されます。 結果セットは、基になるセット内の各項目のコンテナー式を評価することによって取得されたセットの和集合です。

例

この最初の例では、FROM 句を使用して、現在のコンテナーをソースとして指定し、一意の名前を付け、さらに別名を付けています。 別名は、クエリ結果内の特定のフィールドをプロジェクションするために使用されます。

SELECT VALUE {
    name: e.name,
    location: e.workLocation
}
FROM
    employees e

[
  {
    "name": "Tijana Stanković",
    "location": {
      "office": "Redmond, WA"
    }
  },
  {
    "name": "Jean Nadeau",
    "location": {
      "type": "Remote"
    }
  }
]

この次の例では、FROM 句で、ソースを小さなサブセットに限定することもできます。 各項目のサブツリーだけを列挙するには、サブルートをソースにすることができます。 配列またはオブジェクトのサブルートをソースとして使用できます。

SELECT 
    *
FROM
    employees.employment e

[
  {
    "hireDateTime": "2023-01-01T06:30:00.000Z",
    "weeklyHours": 40,
    "team": "Retail support"
  },
  {
    "hireDateTime": "2023-01-01T09:30:00.000Z",
    "team": "Retail support"
  },
  {
    "hireDateTime": "2023-01-01T15:30:00.000Z",
    "weeklyHours": 32,
    "team": "Retail support"
  }
]

関連するコンテンツ

• SELECT 句
• WHERE 句