Atlas SQL ステートメントを使用したクエリ

SELECT ステートメント

SELECT * FROM sessions;

Atlas SQL は、 Sessionsコレクションからすべてのドキュメントを返します。

制限ステートメント

SELECT * FROM users LIMIT 2;

Atlas SQL は、 Usersコレクションから 2 つのドキュメントを返します。

WHERE ステートメント

SELECT * FROM users WHERE name = 'Jon Snow';

Atlas SQL は、ユーザーのnameがJon SnowであるドキュメントをUsersコレクションから返します。

FLATTEN

FLATTEN 半構造化データ（JSON 内の名前と値のペア）を別々の列にフラット化します。 フィールド名は、そのフィールドのすべての値を行に保持する列名になります。

ネストされたドキュメントをフラット化するための構文は、データソースと オプションと組み合わせてFROM句で使用できるFLATTEN関数です。

SELECT *
FROM FLATTEN(<data source>
 WITH DEPTH => <integer>,
 SEPARATOR => <string>
)

平面の例

サンプルシナリオでは、 customerInfoコレクションには次のように構造されたドキュメントが含まれています。

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  }
}

クエリSELECT * FROM customerInfoを実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

クエリSELECT * FROM FLATTEN(customerInfo)を実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

FLATTENを使用すると、元のドキュメントの各フラット化フィールドは結果セットの最上位フィールドになります。 ネストされたフィールドは親フィールド名と連結され、デフォルトの区切り文字_で区切られます。

UNWIND

UNWIND 入力データソースから配列フィールドを分解して、その配列内の各項目に対して 1 行を出力します。 展開の詳細については、 $unwind集計ステージのドキュメントを参照してください。

配列フィールドを展開する構文は、データソースと オプションと組み合わせてFROM句で使用できるUNWIND関数です。

SELECT *
FROM UNWIND(<data source>
 WITH PATH => <array_path>,
 INDEX => <identifier>,
 OUTER => <bool>
)

展開の例

サンプルシナリオでは、 customerInfoコレクションには次のように構造されたドキュメントが含まれています。

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

クエリSELECT * FROM customerInfoを実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

クエリSELECT * FROM UNWIND(customerInfo WITH PATH => visits, INDEX => idx)を実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

UNWINDとPATH => visitsを併用すると、各visitsオブジェクトはテーブル行になります。

FLATTEN と UNIX を組み合わせた例

次の例では、FLATTEN 関数とUNWIND 関数を組み合わせています。

サンプルシナリオでは、 customerInfoコレクションには次のように構造されたドキュメントが含まれています。

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

クエリSELECT * FROM customerInfoを実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

クエリSelect * from FLATTEN(UNWIND(customerInfo WITH PATH => visits, INDEX => idx))を実行すると、Atlas SQL は次の最上位フィールドを持つドキュメントを返します。

FLATTEN関数とUNWIND 関数の両方を使用すると、visits 配列が展開され、結果のドキュメントがフラット化されます。