構文図の読み方
適用対象: Databricks SQL Databricks Runtime
このセクションでは、SQL リファレンス全体で使用される構文のさまざまなパターンについて説明します。
基本コンポーネント
キーワード
SELECT
SQL のキーワードは、このドキュメントでは常に大文字で表記していますが、大文字と小文字は区別されません。
トークン
( )
< >
.
*
,
SQL 言語には、丸かっこ ((
、)
)、山かっこ (<
、>
)、ドット (.
)、コンマ (,
)、および他のいくつかの文字が含まれています。 これらの文字が構文ダイアグラムに含まれている場合は、その文字をそのとおりに入力する必要があります。
句
LIMIT clause
SELECT named_expression
named_expression
expression AS alias
句は、構文の名前付きサブセクションを表します。 ローカル句は、それを呼び出す同じ構文ダイアグラムに記述されています。 句が共通の場合は、Databricks SQL リファレンスの別のセクションにリンクしています。 一部の句は、メインの keyword
によって知られており、大文字のキーワードの後に句を続けた形式で表記されます。 その他の句は常に小文字で、必要に応じてアンダースコア (_
) が使用されます。
ローカル句の詳細については、次のセクションで説明します。
他のすべての句には、短い説明と、メイン ページへのリンクが付されています。
引数
mapExpr
関数の引数は、キャメルケースで指定されます。 Databricks SQL では、引数の意味を「引数」セクションで説明しています。
トークンのチェーン
SELECT expr
空白で区切られたコンポーネントは、無条件で順番に入力する必要があります。また、区切りには空白またはコメントのみを使用する必要があります。 Databricks SQL では、/* ... */
(C スタイル) 形式と -- ...
(行末までが範囲となる) 形式のコメントがサポートされています。
選択肢
構文内での分岐を指定します。
必須の選択
{ INT | INTEGER }
中かっこ { ... }
は、複数のコンポーネントのうちの 1 つだけを指定する必要があることを意味します。
各選択肢は、|
で区切られています。
オプションの選択
[ ASC | DESC ]
角かっこ [ ... ]
は、複数のコンポーネントのうちの 1 つを選択できることを示しています。
各選択肢は、|
で区切られています。
グループ化
{ SELECT expr }
{ SELECT
expr }
中かっこ { ... }
は、すべての埋め込みコンポーネントを指定する必要があることを示します。
構文ダイアグラムが複数の行にまたがっている場合、この形式によって、同じ構文の表記であることを明示します。
オプション
[ NOT NULL ]
角かっこ [...]
は、囲まれているコンポーネントがオプションであることを示しています。
繰り返し
col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]
省略記号 [...]
表記は、直前のコンポーネント、グループ、または選択肢を複数回繰り返すことができることを示します。
省略記号の前に、区切られたドット [. ...]
やコンマ [, ...]
など、別の文字がある場合は、各繰り返しをその文字で区切る必要があります。