Beam Calcite SQL の字句構造

Beam Calcite SQL ステートメントは、一連のトークンで構成されます。トークンには、識別子、引用符付き識別子、リテラル、キーワード、演算子、および特殊文字が含まれます。トークンは、空白 (スペース、バックスペース、タブ、改行) またはコメントで区切ることができます。

識別子

識別子は、列、テーブル、およびその他のデータベースオブジェクトに関連付けられた名前です。

識別子は、文字またはアンダースコアで始める必要があります。後続の文字は、文字、数字、またはアンダースコアにすることができます。引用符付き識別子は、バッククォート (`) 文字で囲まれた識別子であり、スペースや記号などの任意の文字を含めることができます。ただし、引用符付き識別子は空にすることはできません。予約キーワードは、バッククォートで囲まれている場合にのみ識別子として使用できます。

構文 (ここでは正規表現として定義)

[A-Za-z_][A-Za-z_0-9]*

例

Customers5
_dataField1
ADGROUP

無効な例

5Customers
_dataField!
GROUP

5Customers は、文字またはアンダースコアではなく、数字で始まっています。_dataField! には、文字、数字、またはアンダースコアではない特殊文字「!」が含まれています。GROUP は予約キーワードであるため、バッククォート文字で囲まれていない場合は識別子として使用できません。

識別子と引用符付き識別子の両方で大文字と小文字は区別されませんが、いくつかのニュアンスがあります。詳細については、大文字と小文字の区別を参照してください。

引用符付き識別子には、以下で定義されている文字列リテラルと同じエスケープシーケンスがあります。

リテラル

リテラルは、組み込みデータ型の定数値を表します。一部のデータ型はリテラルとして表現できますが、すべてではありません。

文字列リテラル

文字列リテラルとバイトリテラルの両方は、単一 (') 引用符で引用符で囲む必要があります。

引用符付きリテラル

整数リテラル

整数リテラルは、10 進数字 (0 から 9) のシーケンスです。整数には、正の値と負の値をそれぞれ表すために、「+」または「-」をプレフィックスとして付けることができます。

例

123
-123

整数リテラルは BIGINT として解釈されます。

浮動小数点リテラル

構文オプション

[+-]DIGITS.[DIGITS][e[+-]DIGITS]
[DIGITS].DIGITS[e[+-]DIGITS]
DIGITSe[+-]DIGITS

DIGITS は 1 つ以上の 10 進数 (0 から 9) を表し、e は指数マーカー (e または E) を表します。

例

123.456e-67
.1E4
58.
4e2

小数点または指数マーカーを含む数値リテラルは、double 型であると想定されます。

値が有効な float 範囲内にある場合、浮動小数点リテラルを float 型に暗黙的に強制変換できます。

NaN または無限大のリテラル表現はありません。

配列リテラル

配列リテラルは、ARRAY キーワードがプレフィックスとして付けられた角かっこで囲まれた、カンマ区切りの要素リストです。

例

ARRAY[1, 2, 3]
ARRAY['x', 'y', 'xy']

構造体リテラル

構文

(elem[, elem...])

elem は構造体内の要素です。elem は、式または列名ではなく、リテラルデータ型である必要があります。

出力型は、(構造体は名前付き型ではありません) 入力式の型に一致する型を持つ匿名フィールドを持つ匿名構造体型です。

日付リテラル

構文

DATE 'YYYY-M[M]-D[D]'

日付リテラルには、DATE キーワードの後に、単一引用符で囲まれた標準の日付形式に準拠する文字列リテラルが含まれます。日付リテラルは、1 年から 9999 年 (両端を含む) の範囲をサポートします。この範囲外の日付は無効です。

たとえば、次の日付リテラルは 2014 年 9 月 27 日を表します。

DATE '2014-09-27'

標準の日付形式の文字列リテラルも、DATE 型の式が予期される場所で使用すると、暗黙的に DATE 型に強制変換されます。たとえば、クエリでは

SELECT * FROM foo WHERE date_col = "2014-09-27"

文字列リテラル "2014-09-27" は日付リテラルに強制変換されます。

時間リテラル

構文

TIME '[H]H:[M]M:[S]S[.DDDDDD]]'

TIME リテラルには、TIME キーワードと、単一引用符で囲まれた標準の時間形式に準拠する文字列リテラルが含まれます。

たとえば、次の時間は午後 12 時 30 分を表します。

TIME '12:30:00.45'

タイムスタンプリテラル

構文

TIMESTAMP 'YYYY-[M]M-[D]D [[H]H:[M]M:[S]S[.DDDDDD]]'

タイムスタンプリテラルには、TIMESTAMP キーワードと、単一引用符で囲まれた標準のタイムスタンプ形式に準拠する文字列リテラルが含まれます。

タイムスタンプリテラルは、1 年から 9999 年 (両端を含む) の範囲をサポートします。この範囲外のタイムスタンプは無効です。

たとえば、次のタイムスタンプは 2014 年 9 月 27 日の午後 12 時 30 分を表します。

TIMESTAMP '2014-09-27 12:30:00.45'

大文字と小文字の区別

Beam SQL では、大文字と小文字の区別に関して次の規則に従います。

予約キーワード

キーワードは、Beam SQL 言語で特別な意味を持つトークンのグループであり、次の特性があります。

• キーワードは、バッククォート (`) 文字で囲まれていない限り、識別子として使用できません。
• キーワードでは大文字と小文字は区別されません。

Beam SQL には、次の予約キーワードがあります。

終端セミコロン

ステートメントは、アプリケーションプログラミングインターフェース（API）を通じて送信されるクエリ文字列のコンテキストで、オプションで終端セミコロン（;）を使用できます。一部のインタラクティブツールでは、ステートメントに終端セミコロンが必要です。複数のステートメントを含むリクエストでは、ステートメントはセミコロンで区切る必要がありますが、最後のステートメントではセミコロンはオプションです。

コメント

コメントは、パーサーによって無視される文字のシーケンスです。Beam SQLは、次のタイプのコメントをサポートしています。

単一行コメント

1行コメントは、コメントの前に--を付けることでサポートされます。

例

SELECT x FROM T; --xはフィールドで、Tはテーブルです

コメントには、'--'シーケンスから行末までのすべての文字が含まれます。オプションで、'--'の後にスペースを追加できます。

複数行コメント

複数行のコメントは、/* <コメント> */を使用してコメントを囲むことでサポートされます。

例

SELECT x FROM T /* x is a field and T is a table */
WHERE x = 3;

無効な例

SELECT x FROM T /* comment starts here
                /* comment ends on this line */
                this line is not considered a comment */
WHERE x = 3;

コメントには、改行を含むすべての文字が、最初の出現箇所である'/*'と、その後の最初の出現箇所である'*/'で囲まれています。ネストされたコメントはサポートされていません。2番目の例には、クエリを無効にするネストされたコメントが含まれています。

このページのコンテンツの一部は、Googleが作成および共有したものを基に修正したものであり、Creative Commons 3.0 Attribution Licenseに記載された条件に従って使用されています。