SQL リファレンスの使用方法

適用対象:チェックマーク、はい 、Databricks、SQL 、チェックマーク、はい 、Databricksランタイム。

このガイドでは、プラットフォームの可用性ラベルや構文表記など、SQL 言語リファレンスの読み取りと移動の方法について説明します。

"適用対象" ラベル

SQL リファレンスは Databricks SQL、Databricks Runtime、Unity Catalog、および Lakehouse//RT をカバーします。 各ページの上部には「適用対象」ラベルがあり、どの製品やバージョンがその機能をサポートしているかを示します。

ラベルを読む

ラベル 説明
チェック はいDatabricks SQL チェック チェック は はい Databricks ランタイム Databricks SQL と Databricks Runtime の両方のすべてのバージョン
チェック はいDatabricks SQL Databricks SQL のみ (Databricks ランタイムではサポートされていません)
チェック チェック はい Databricks SQL にチェックマークが付けた はいDatabricks ランタイム 11.3 LTS 以上 Databricks SQL および Databricks Runtime 11.3 LTS 以降のすべてのバージョン
チェック はい Databricks SQL チェック チェック はい Databricks ランタイム 11.3 LTS 以上 はい にチェックマーク Unity カタログのみ Unity カタログのみ、Databricks SQL のすべてのバージョン、および Databricks Runtime 11.3 LTS 以降
チェック はい Databricks SQL チェック は yesDatabricks ランタイム 17.1 以上 はい Lakehouse//RT Databricks SQL、Databricks Runtime 17.1 以上、および Lakehouse//RT のすべてのバージョン。 Lakehouse//RT は SQL 言語の一部のみをサポートしています。 レイクハウスリアルタイムを参照してください。

パラメータレベルのラベル

一部の記事では、上部に "適用対象" ラベルがあり、アーティクル内の特定のパラメーターに対して追加のラベルがあります。 パラメーター レベルのラベルは、そのパラメーターのアーティクル レベルのラベルのみをオーバーライドします。

例 1: パラメーターには Databricks ランタイムの最小バージョンが必要

記事ラベル: Databricks SQL チェック Databricks Runtime" とマークされたチェック

パラメーター ラベル: Databricks SQL チェック Databricks Runtime 11.3 LTS 以降" とマークされたチェック

つまり、ほとんどの記事は Databricks SQL と Databricks Runtime の両方のすべてのバージョンに適用されますが、その特定のパラメーターには Databricks Runtime 11.3 LTS 以降が必要です。

例 2: SQL ウェアハウスワークロードでパラメーターを使用できない

記事ラベル: Databricks SQL チェック Databricks Runtime" とマークされたチェック

パラメーター ラベル: "はい Databricks Runtime 11.3 LTS 以降" とマークされているチェック

つまり、ほとんどのページは両方の製品のすべてのバージョンに適用されますが、特定のパラメーターは Databricks Runtime 11.3 LTS 以降でのみサポートされます (Databricks SQL ではサポートされていません)。


構文図

SQL ステートメントは、有効なコマンドの作成方法を示す構文図を使用して文書化されています。

基本要素

構文図では、これらの基本コンポーネントを使用して SQL ステートメントを表します。 各コンポーネントの後に例が続きます。

Keyword

キーワードは大文字で表示されますが、大文字と小文字は区別されません。

SELECT

トークン

次のように正確に入力する必要があるリテラル文字: (、 )、 <、 >、 .、 *、 ,

条項

句は名前付き構文セクションです。 大文字の句 ( LIMIT clause など) は、そのドキュメントにリンクされます。 アンダースコアを持つ小文字の句 ( named_expressionなど) はローカルで定義されます。

LIMIT clause
named_expression

Argument

関数引数は camelCase を使用し、Databricks SQL 関数リファレンスの「引数」セクションで説明されています。

mapExpr

構文表記

特殊記号は、コンポーネントを結合、繰り返し、または省略する方法を示します。

必須シーケンス

空白で区切られたコンポーネントは順番に表示する必要があります。

SELECT expr

必須の選択

中かっこ{ }|区切り記号が付いているので、1 つのオプションを選択する必要があります。

{ INT | INTEGER }

オプションの選択

角かっこ[ ]|区切り記号を使用すると、最大 1 つのオプションを選択できます。

[ ASC | DESC ]

Grouping

中かっこ{ }|指定しない場合は、すべてのコンポーネントを含める必要があります。

{ SELECT expr }

オプション要素

角かっこ [ ] 、囲まれたコンポーネントが省略可能であることを意味します。

[ NOT NULL ]

繰り返し

省略記号 [...] は、前のコンポーネントを繰り返すことができるということです。 区切り記号 (, ...) が前にある場合は、繰り返し間でその区切り記号を使用する必要があります。

col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]

Comments

Databricks SQL では、C スタイルのコメント (/* ... */) と行コメント (-- ...) がサポートされています。