Atlas SQL 言語リファレンス

データ型

Atlas SQL データ型は BSON types のセットです 。Atlas SQL ではこれらのすべてのタイプをクエリできます。 これらは次のとおりです。

• string （STRING）

• ドキュメント（ DOCUMENT ）

• 配列（ ARRAY ）

• BinData (BINDATA)

• ObjectId (OBJECTID)

• ブール値（ BOOL ）

• 日付（ TIMESTAMP ）

• null（ NULL ）

• 正規表現（ REGEX ）

• 32 ビット整数（INT）

• double （DOUBLE）

• Long (LONG)

• タイムスタンプ（ BSON_TIMESTAMP ）

• 小数（ DECIMAL ）

• MinKey（ MINKEY ）

• MaxKey（ MAXKEY ）

• DBPointer（ DBPOINTER ）

• シンボル（ SYMBOL ）

• JavaScriptとスコープ（JAVASCRIPTWITHSCOPE）

• JavaScript（ JAVASCRIPT ）

Atlas SQL の各型には名前（上記の括弧内）があります。これは、必要に応じて型を参照するために使用できるキーワードです（例: CASTのような式では）。

タイプの変換

明示的な型変換はCAST関数または::演算子を使用して表現されます。 数値型はすべて相互に同等です。 Atlas SQL では、オペランドを同じ数値型にキャストすることなく、さまざまな数値型間で操作を実行できます。

Schemas

Atlas SQL は、スキーマを使用して MongoDB の柔軟なドキュメント値をタイプに変換します。 Atlas SQL スキーマは、コンパイル時に true であることが確認されている式またはコレクションに関するファセットのコレクションです。

たとえば、Atlas SQL スキーマは、式がブール値またはサブフィールドを持つドキュメントのいずれかであること、または式が長さが1の配列または正の整数であることを指定できます。

静的型制約が満たされない場合、クエリはコンパイルされません。

SELECT

SELECT は、すべての Atlas SQL クエリを開始します。 Atlas SQL では、 SELECT VALUEとSELECT VALUESをどちらも使用できます。

Atlas SQL では、エイリアスが存在するためにネストされたSELECTステートメントが必要です。

SELECT foo FROM (SELECT bar FROM baz) as subSelect

SELECT * FROM table WHERE period_start_utc >= CAST('2023-01-01T00:00:00.000Z' AS TIMESTAMP)

from

FROM は、すべての Atlas SQL クエリで評価される最初の句です。

FROM は、コレクション(SELECT * FROM foo) 、配列(SELECT * FROM [{'a': 1}]) 、結合(SELECT * FROM a JOIN b) 、 派生テーブル(SELECT * FROM (SELECT a FROM foo) d) 、 FLATTEN と UNIX などのさまざまなソースからデータを取得できます。

WHERE

WHERE句は受信データのフィルタです。 その式は静的にタイプBOOLまたはNULLである必要があり、 MISSINGと評価される可能性があります。

グループ化基準：

GROUP BY データをグループ化および集計するための手段を提供します。

FLATTEN または UNIXを使用してフラット化されたフィールドでGROUP BYを使用する場合は、エイリアスが必要です。

SELECT customerAge, COUNT(*) FROM Sales GROUP BY customer.age AS customerAge

HAVING

HAVING句はWHERE句と同じように動作しますが、 GROUP BY句の後に動作します。 WHERE句と同様に、 HAVING句は静的にBOOLタイプまたはNULLタイプである必要があり、 MISSINGと評価される可能性がある 式 を使用します。 GROUP BYで定義されたエイリアスを参照し、集計関数を持つ式を含めることができます。 GROUP BYで定義されたエイリアスのみがHAVING句で使用できます。

並び替え基準：

ORDER BY句は、1 つ以上のソートキーで結果セットを並べ替える方法を提供します。 各ソートキーは、列参照、または選択された式リスト内の位置によりSELECT式を参照する整数リテラルのいずれかになります。 列参照であるソートキーは、複合識別子にすることができます。 これらの複合識別子は、データソース名で修飾したり、ドキュメント サブフィールドを参照したりできます。

Atlas SQL は、MISSING NULLNULLを の前にソートし、 を他のすべての値の前にソートします。ORDER BY句では、ソートキー式内のすべての可能な値が、 > （より大きい）および< （より小さい）演算子によって同等であることが静的に検証される必要があります。

制限とオフセット

LIMITおよびOFFSET句を使用すると、ユーザーはクエリによって返された行の一部のみを取得できます。 LIMITという数値が指定された場合、その行数以上の行は返されません。 OFFSET数値が指定されている場合、その行数は行を返す前にスキップされます。

LIMITとOFFSETの数値はいずれも正の整数である必要があります。 なしでLIMIT またはOFFSET ORDER BYを使用しても、同じ結果は保証されません。

LIMITとOFFSETの両方が設定されている場合、結果の残りを返す前にOFFSET行がスキップされます。この行には、 LIMIT桁の行以下が含まれる必要があります。

LIMIT i, j はLIMIT i OFFSET jの短縮形です。

LIMIT とOFFSETはサブクエリで使用できます。

Identifiers

Atlas SQL の識別子は、データベース、テーブル、および列を参照します。 Atlas SQL 識別子は、null 文字\x00を除くすべての UTF- 8文字をサポートします。

Atlas SQL 、他のセマンティック意味を持つ文字との競合を避けるために、一部の識別子は制限されています。識別子にこのような文字を含めるには、区切りである必要があります。つまり、 double引用符またはバッククションで囲む必要があります。 例えば、識別子が数字で始まる場合や予約済みのキーワードと競合する場合（例: "10cent" ）。 識別子は、区切り文字が含まれているかどうかにかかわらず、大文字と小文字を区別します。

Aliases

Atlas SQL のすべてのエイリアスに識別子が使用されます。 ほとんどの場合、エイリアスが同じ句で複数回使用されると、Atlas SQL はエラーを返します。 ただし、 UNION ALLの両方でエイリアスを繰り返すことができることです。 これは、自動生成エイリアスにも適用されます。

Keywords

Atlas SQL キーワード（ SELECT 、 FROM 、 JOINなど）は、非区切り識別子として使用できません。

リテラル

Atlas SQL は、ブール値、null、数値、string のリテラルをサポートしています。 stringは一重引用符で囲みます。 stringリテラルに一double引用符を含めるには、二重引用符（'o''clock'）にします。

リテラル整数は、 32ビットの符号付き整数範囲内にある場合はINTと入力され、それ以外の場合はLONGと入力されます。 リテラル浮動小数点数または科学表記数のタイプはDOUBLEです。

Atlas SQL はすべての型のリテラルをサポートしていません。たとえば、 OBJECTID 、 BSON_DATE 、DECIMALにはリテラル構文がありません。このような型の場合、CAST演算子を使用してそれらの型の string または数値表現をそれぞれの型に取得することで、疑似リテラル値を取得できます。一部のタイプには、関連するCAST呼び出しをエイリアスする「コンストラクター」関数がある場合もあります。

括弧付き式

括弧付き式は、括弧でグループ化された式です。 インデックス演算子が存在する場合には常に、操作の順序を区別するために括弧（または同様のメカニズム）が必要になる場合があります。 Atlas SQL には、 +や::などのいくつかの挿入演算子があります。 たとえば、 1 + 2 * 3の値は7で、 (1 + 2) * 3の値は9です。

演算子

Atlas SQL は次の基本演算子をサポートしています。

• +

• -

• *

• /

• ||

• <

• <=

• !=

• ==

• >

• >=

• BETWEEN

• AND

• OR

• NOT

サブクエリ式

サブクエリは、クエリ内の SQL クエリです。 サブクエリは、 式 を使用できる任意の場所で使用できます。

Atlas SQL は、スカラー サブクエリとテーブル サブクエリをサポートしています。 スカラーサブクエリは、0 または 1 行と 1 列を含む結果セットを返します。 リテラルまたは単一列の値が有効なほとんどの場所で使用できます。 テーブル サブクエリは、0 個以上の行と 1 つ以上の列を返します。

ドキュメント式とフィールドアクセス式

ドキュメントは、JSON オブジェクトと同様の構文で表すことができます。 キーは string である必要があり、値はサポートされている任意の 型にすることができます。 ドキュメント フィールドにアクセスするために、Atlas SQL は「ドット」表記と「括弧」表記の 2 つのオプションをサポートしています。

ドット表記は、MongoDB 集計のフィールド アクセスに似ています。 たとえば、ドキュメントdocにフィールドfが含まれている場合、そのフィールドの値にアクセスするために式doc.fが使用されます。 括弧表記では、フィールド名を囲む角括弧（ [と] ）を使用して、その名前のフィールドにアクセスします。 たとえば、以前に説明されている同じドキュメントを考えてみましょう。そのフィールドの値にアクセスするにはdoc["f"]が使用されます。

null と欠落

BSON ではNULLとMISSINGを区別します。 NULLの場合、リテラル値NULLを持つフィールドが存在しますが、 MISSINGの場合では、このフィールドはなくなります。