次の方法で共有

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

適用対象:チェック済み: はい Databricks SQLチェック済み: はい Databricks Runtime

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

"適用対象" ラベル

SQL リファレンスでは、Databricks SQL、Databricks Runtime、および Unity カタログについて説明します。 各記事には、その機能をサポートする製品とバージョンを示す "適用対象" ラベルが上部近くに含まれています。

ラベルの読み取り

ラベル 説明
Databricks SQL チェックが Databricks ランタイム Databricks SQL と Databricks Runtime の両方のすべてのバージョン
Databricks SQL Databricks SQL のみ (Databricks ランタイムではサポートされていません)
Databricks SQL チェックが Databricks Runtime 11.3 LTS 以降 Databricks SQL および Databricks Runtime 11.3 LTS 以降のすべてのバージョン
Databricks SQL チェックが yes Databricks Runtime 11.3 LTS とマークされ、上記のチェックははい Unity カタログのみとマークされています Unity カタログのみ、Databricks SQL のすべてのバージョン、および Databricks Runtime 11.3 LTS 以降

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

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

例 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 スタイルのコメント (/* ... */) と行コメント (-- ...) がサポートされています。

  • Last updated on