構文図の読み方

適用対象:「はい」のチェック マーク 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 } [, ...]

省略記号 [...] 表記は、直前のコンポーネント、グループ、または選択肢を複数回繰り返すことができることを示します。 省略記号の前に、区切られたドット [. ...] やコンマ [, ...] など、別の文字がある場合は、各繰り返しをその文字で区切る必要があります。