SQL 言語リファレンス

これは、Databricks SQL と Databricks Runtime の SQL コマンドリファレンスです。

このリファレンスの構文表記と記号を理解して使用する方法については、 SQL リファレンスの使用方法を参照してください。

Lakeflow Spark 宣言パイプラインで SQL を使用する方法については、「パイプライン SQL 言語リファレンス」を参照してください。

Note

Databricks SQL Serverless は、Azure China リージョンでは利用できません。 Databricks SQL は、Azure Government リージョンでは利用できません。

一般的なリファレンス

この一般的なリファレンスでは、データ型、関数、識別子、リテラル、セマンティクスについて説明します。

言語の基礎

リファレンス	Description
SQL ステートメントへのコメントの追加	SQL コードへのコメントの追加
予約語とスキーマ	SQL パーサーによって予約されたキーワード
Identifiers	データベースオブジェクトに名前を付けるための規則
Names	オブジェクトの名前付け規則
IDENTIFIER 句	動的識別子の解決
SQL 式	SQL 式の構文と評価
NULL の意味論	NULL 値の処理方法
パラメーターマーカー	パラメーター化されたクエリプレースホルダー
Variables	セッション変数と一時変数
名前解決	オブジェクト名の解決方法
JSON パス式	JSON データ構造の移動
Collation	文字列の比較と並べ替えの規則
Partitions	テーブルのパーティション分割の概念

データ型

リファレンス	Description
データ型	サポートされているすべてのデータ型の概要
SQL データ型の規則	型強制型と変換規則
日付時刻のパターン	日付と時刻のパターンを書式設定する

構成パラメーター

リファレンス	Description
構成パラメーター	SQL 構成の概要
ANSI_MODE	ANSI SQL コンプライアンスモード
LEGACY_TIME_PARSER_POLICY	時間解析の動作
MAX_FILE_PARTITION_BYTES	ファイルパーティションのサイズ制限
READ_ONLY_EXTERNAL_METASTORE	外部メタストアアクセスモード
STATEMENT_TIMEOUT	クエリのタイムアウト設定
TIMEZONE	セッションタイムゾーン
USE_CACHED_RESULT	クエリ結果のキャッシュ

Functions

リファレンス	Description
Functions	SQL 関数の概要
組み込み関数	すべての組み込み関数
組み込み関数のアルファベット順一覧	A から Z 関数の完全なリファレンス
ウィンドウ関数	分析関数とランク付け関数
ラムダ関数	匿名関数式
H3 地理空間関数	六角形階層空間インデックス
ST 地理空間関数	標準地理空間関数
ユーザー定義集計関数 (UDAF)	カスタム集計関数
外部ユーザー定義スカラー関数 (UDF)	カスタムスカラー関数
Hive UDF、UDAF、UDTF との統合	Hive 関数の互換性
関数の呼び出し	関数を呼び出す方法

Unity カタログの概念

リファレンス	Description
プリンシパル	ユーザー、グループ、およびサービスプリンシパル
Unity Catalog の権限とセキュリティ保護可能なオブジェクト	Unity カタログでのアクセス制御
Hive メタストアの権限とセキュリティ保護可能なオブジェクト	従来のメタストアアクセス制御
外部の場所	クラウドストレージの場所
外部テーブルをする	外部データによってサポートされるテーブル
Credentials	ストレージアクセス資格情報
Volumes	マネージドファイルストレージと外部ファイルストレージ

特別なトピック

リファレンス	Description
Databricks Runtime での ANSI 準拠	ANSI SQL 標準の互換性
Apache Hive の互換性	Hive SQL の互換性
SQL スクリプト	手続き型 SQL ロジック
デルタ・シェアリング	組織間のデータ共有
フェデレーションクエリ (Lakehouse フェデレーション)	外部データベースのクエリ
情報スキーマ	メタデータシステムテーブル

DDL ステートメント

データ定義ステートメントは、データベースオブジェクトの構造を作成または変更します。

ALTER ステートメント

ステートメント	Description
ALTER CATALOG	カタログのプロパティを変更する
ALTER CONNECTION	接続設定を変更する
ALTER CREDENTIAL	資格情報のプロパティを変更する
ALTER DATABASE	データベースのプロパティを変更する
ALTER EXTERNAL LOCATION	外部の場所を変更する
ALTER MATERIALIZED VIEW	具体化されたビューを変更する
ALTER PROVIDER	データプロバイダーの変更
ALTER RECIPIENT	共有の受信者を変更する
ALTER SCHEMA	スキーマのプロパティを変更する
ALTER SHARE	共有構成の変更
ALTER STREAMING TABLE	ストリーミングテーブルの変更
ALTER TABLE	テーブル構造の変更
ALTER VIEW	ビュー定義の変更
ALTER VOLUME	ボリュームのプロパティを変更する

CREATE ステートメント

ステートメント	Description
CREATE BLOOM FILTER INDEX	ブルームフィルターインデックスを作成する
CREATE CATALOG	新しいカタログを作成する
CREATE CONNECTION	外部接続を作成する
CREATE DATABASE	新しいデータベースの作成
CREATE FUNCTION (SQL と Python)	SQL 関数を作成する
CREATE FUNCTION (外部)	外部関数を作成する
CREATE EXTERNAL LOCATION	外部の場所を作成する
CREATE MATERIALIZED VIEW	具体化されたビューを作成する
プロシージャを作成する	ストアドプロシージャを作成する
CREATE RECIPIENT	共有受信者を作成する
CREATE SCHEMA	新しいスキーマを作成する
CREATE SERVER	外部サーバーを作成する
CREATE SHARE	データ共有を作成する
CREATE STREAMING TABLE	ストリーミングテーブルを作成する
CREATE TABLE	新しいテーブルを作成する
CREATE VIEW	ビューを作成する
CREATE VOLUME	ボリュームを作成する

Analyze ステートメント

その他の DDL ステートメント

ステートメント	Description
COMMENT ON	オブジェクトにコメントを追加する
DECLARE VARIABLE	セッション変数を宣言する
REPAIR TABLE	テーブルパーティションを回復する
REFRESH FOREIGN (CATALOG、 SCHEMA、および TABLE)	外部メタデータを更新する
REFRESH (MATERIALIZED VIEW または STREAMING TABLE)	具体化されたデータを更新する
SET タグ	オブジェクトにタグを追加する
`SYNC`	メタデータを同期する
TRUNCATE TABLE	すべてのテーブルデータを削除する
UNDROP	削除されたテーブルを復元する
タグの設定を解除する	オブジェクトからタグを削除する

DML ステートメント

データ操作ステートメントは、Delta Lake テーブルのデータを追加、変更、または削除します。

ステートメント	Description
`COPY INTO`	ファイルからテーブルにデータを読み込む
DELETE FROM	テーブルから行を削除する
INSERT	テーブルに行を挿入する
INSERT OVERWRITE DIRECTORY	ディレクトリにクエリ結果を書き込む
INSERT OVERWRITE DIRECTORY (Hive形式を使用)	Hive 形式で結果を書き込む
LOAD DATA	ファイルからデータを読み込む
MERGE INTO	テーブルにデータをアップサートする
UPDATE	テーブル内の行を更新する

データ取得ステートメント

指定した句に従ってテーブルから行を取得します。 Azure Databricks では、標準の SELECT 構文と SQL パイプライン構文の両方がサポートされています。

クエリステートメント

ステートメント	Description
Query	完全なクエリ構文リファレンス
SELECT (サブセレクト)	テーブルからデータを選択する
VALUES 句	インラインテーブルを構築する
SQL パイプライン構文	パイプベースのクエリ構成
EXPLAIN	クエリ実行プランを表示する

クエリ句

条項	Description
SELECT 句	列の選択
* (star) 句	すべての列を選択する
テーブル参照	テーブルとサブクエリのソース
JOIN	テーブルの行を結合する
WHERE 句	行のフィルター
GROUP BY 句	集計のために行をグループ化する
HAVING 句	グループ化された行をフィルター処理する
QUALIFY 句	フィルターウィンドウ関数の結果
ORDER BY 句	結果行の並べ替え
SORT BY 句	パーティション内での並べ替え
CLUSTER BY 句 (SELECT)	データの分散と並べ替え
DISTRIBUTE BY 句	パーティション間でデータを分散する
LIMIT 句	結果行を制限する
OFFSET 句	結果行をスキップする
PIVOT 句	行を列に回転する
UNPIVOT 句	列を行に回転する
LATERAL VIEW 句	テーブル生成関数を適用する
TABLESAMPLE 句	テーブル行のサンプル
テーブル値関数 (TVF) の呼び出し	テーブルを返す関数
共通テーブル式 (CTE)	名前付きサブクエリ
集合演算子	UNION、INTERSECT、EXCEPT
WINDOW 句	名前付きウィンドウ定義
[ヒント]	クエリオプティマイザーヒント

Delta Lake ステートメント

Delta Lake 形式で格納されているテーブルを管理します。詳細については、「 Azure Databricks の Delta Lake とは」を参照してください。

ステートメント	Description
CACHE SELECT	クエリ結果をキャッシュする
CONVERT TO DELTA	Parquet から Delta への変換
DESCRIBE HISTORY	テーブル履歴を表示する
FSCK REPAIR TABLE	テーブルのメタデータを修復する
GENERATE	テーブルマニフェストの生成
OPTIMIZE	コンパクトテーブルファイル
REORG TABLE	テーブルデータの再構成
RESTORE	テーブルを以前のバージョンに復元する
VACUUM	古いテーブルファイルを削除する

SQL スクリプトステートメント

SQL で手続き型ロジックを実行します。概要については、 SQL スクリプトを参照してください。

ステートメント	Description
BEGIN END 複合ステートメント	ステートメントをブロックにグループ化する
CASE ステートメント	条件分岐
FOR ステートメント	範囲またはカーソルのループ
GET DIAGNOSTICS ステートメント	実行情報を取得する
IF THEN ELSE ステートメント	条件付き実行
ITERATE ステートメント	次のループイテレーションに進む
LEAVE ステートメント	ループまたはブロックを終了する
LOOP ステートメント	無条件ループ
REPEAT ステートメント	条件が true になるまでループする
RESIGNAL ステートメント	例外を再発生させる
SIGNAL ステートメント	例外を発生させる
WHILE ステートメント	条件が true の間にループする

補助宣言

統計の収集、キャッシュの管理、メタデータの探索、構成の設定、リソースの管理を行います。

ANALYZE ステートメント

ステートメント	Description
ANALYZE TABLE … コンピューティング統計	テーブル列の統計を計算する
ANALYZE TABLE … コンピューティングストレージメトリック	コンピューティングテーブルストレージのメトリック

キャッシュステートメント

適用対象: Databricks ランタイム

ステートメント	Description
CACHE TABLE	メモリ内のキャッシュテーブル
CLEAR CACHE	キャッシュされたすべてのデータを削除する
REFRESH CACHE	キャッシュされたデータを更新する
REFRESH FUNCTION	関数のメタデータを更新する
REFRESH TABLE	テーブルのメタデータを更新する
UNCACHE TABLE	キャッシュからテーブルを削除する

DESCRIBE ステートメント

ステートメント	Description
DESCRIBE CATALOG	カタログの詳細を表示する
DESCRIBE CONNECTION	接続の詳細を表示する
DESCRIBE CREDENTIAL	資格情報の詳細を表示する
DESCRIBE DATABASE	データベースの詳細を表示する
DESCRIBE FUNCTION	関数の詳細を表示する
DESCRIBE EXTERNAL LOCATION	場所の詳細を表示する
手順を説明する	プロシージャの詳細を表示する
DESCRIBE PROVIDER	プロバイダーの詳細を表示する
DESCRIBE QUERY	クエリ出力スキーマを表示する
DESCRIBE RECIPIENT	受信者の詳細を表示する
DESCRIBE SCHEMA	スキーマの詳細を表示する
DESCRIBE SHARE	共有の詳細を表示する
DESCRIBE TABLE	テーブルの詳細を表示する
DESCRIBE VOLUME	ボリュームの詳細を表示する

SHOW ステートメント

ステートメント	Description
LIST	パス内のファイルを一覧表示する
SHOW ALL IN SHARE	共有内のすべてのオブジェクトを表示する
SHOW CATALOGS	カタログを一覧表示する
SHOW COLUMNS	テーブルの列を一覧表示する
SHOW CONNECTIONS	接続の一覧表示
SHOW CREATE TABLE	テーブル DDL の表示
SHOW CREDENTIALS	資格情報を一覧表示する
SHOW DATABASES	データベースを一覧表示する
SHOW FUNCTIONS	関数を一覧表示する
SHOW GROUPS	グループの一覧表示
SHOW EXTERNAL LOCATIONS	外部の場所を一覧表示する
SHOW PARTITIONS	テーブルパーティションを一覧表示する
プロシージャの表示	プロシージャを一覧表示する
SHOW PROVIDERS	プロバイダーを一覧表示する
SHOW RECIPIENTS	受信者を一覧表示する
SHOW SCHEMAS	スキーマを一覧表示する
SHOW SHARES	共有を一覧表示する
SHOW SHARES IN PROVIDER	プロバイダーからの共有を一覧表示する
SHOW TABLE EXTENDED	テーブル情報を表示する
SHOW TABLES	テーブルを一覧表示する
SHOW TABLES DROPPED	削除されたテーブルを一覧表示する
SHOW TBLPROPERTIES	テーブルのプロパティを表示する
SHOW USERS	ユーザーを一覧表示する
SHOW VIEWS	リストビュー
SHOW VOLUMES	ボリュームを一覧表示する

構成と変数の管理

ステートメント	Description
CALL	ストアドプロシージャを呼び出す
EXECUTE IMMEDIATE	動的 SQL の実行
RESET	構成を既定値にリセットする
SET	構成パラメーターを設定する
SET RECIPIENT	共有受信者のコンテキストを設定する
SET TIME ZONE	セッションのタイムゾーンを設定する
変数 SET	変数の値を設定する
USE CATALOG	現在のカタログを設定する
USE DATABASE	現在のデータベースを設定する
USE SCHEMA	現在のスキーマを設定する

リソース管理