SQL リファレンス
これは、Databricks SQL と Databricks Runtime の SQL コマンド リファレンスです。
Note
Databricks SQLは、Azure China リージョンでは利用できません。
"適用対象" ラベル
SQL リファレンスには、Databricks SQL と Databricks Runtime の両方が含まれます。 各記事の先頭近くには、その記事でサポートされている製品とバージョンを示すラベルがあります。
たとえば、この記事は、Databricks SQL と Databricks Runtime の両方のすべてのバージョンに適用されます。
適用対象:
Databricks SQL Databricks Runtime
この例では、この記事は、Databricks SQL および Databricks Runtime バージョン 11.1 以降のすべてのバージョンに適用されます。
適用対象: Databricks SQL Databricks Runtime 11.1 以降
この例では、この記事は Databricks SQL にだけ適用され、Databricks Runtime ではサポートされていません。
適用対象: Databricks SQL
場合によっては、記事はほとんど製品に適用されますが、記事内の特定のパラメーターが、1 つの製品または特定のバージョンの製品によってのみサポートされます。 この場合は、"適用対象" ラベルが、記事本文中の該当するパラメーターに挿入されます。 次に例を示します。
記事の先頭に次のように示されているとします。適用対象: Databricks SQL Databricks Runtime
記事内の 1 つの特定のパラメーターに次のように示されているとします。適用対象: Databricks SQL Databricks Runtime 11.1 以降。 これは、ドキュメントのほとんどは Databricks SQL と Databricks Runtime の両方のすべてのバージョンでサポートされ、その特定のパラメーターは Databricks SQL のすべてのバージョンと、Databricks Runtime バージョン 11.1 以降でのみサポートされることを意味します。
記事内のもう 1 つの特定のパラメーターに次のように示されているとします。適用対象: Databricks Runtime 11.1 以降。 これは、ドキュメントのほとんどは Databricks SQL と Databricks Runtime のすべてのバージョンでサポートされますが、その特定のパラメーターは Databricks SQL でサポートされず、Databricks Runtime バージョン 11.1 以降でのみサポートされることを意味します。
一般的なリファレンス
この一般的なリファレンスでは、データ型、関数、識別子、リテラル、セマンティクスについて説明します。
- 構文図の読み方
- 構成パラメータ
- データ型とリテラル
- 関数
- SQL データ型のルール
- datetime パターン
- H3 地理空間の関数
- ラムダ関数
- ウィンドウ関数
- 識別子
- [名前]
- NULL セマンティクス
- 式
- 名前解決
- JSON パス式
- パーティション
- ANSI 準拠
- Apache Hive の互換性
- プリンシパル
- Unity Catalog の権限とセキュリティ保護可能なオブジェクト
- Hive メタストアの権限とセキュリティ保護可能なオブジェクト
- 外部の場所
- 外部テーブル
- ストレージの資格情報
- Delta Sharing
- 情報スキーマ
- 予約語
DDL ステートメント
データ定義ステートメントを使用して、データベース内のデータベース オブジェクトの構造を作成または変更します。
- ALTER CATALOG
- ALTER CREDENTIAL
- ALTER DATABASE
- ALTER LOCATION
- ALTER PROVIDER
- ALTER RECIPIENT
- ALTER TABLE
- ALTER SCHEMA
- ALTER SHARE
- ALTER VIEW
- COMMENT ON
- CREATE BLOOMFILTER INDEX
- CREATE CATALOG
- CREATE DATABASE
- CREATE FUNCTION (SQL)
- CREATE FUNCTION (外部)
- CREATE LOCATION
- CREATE RECIPIENT
- CREATE SCHEMA
- CREATE SHARE
- CREATE TABLE
- CREATE VIEW
- DROP BLOOMFILTER INDEX
- DROP CATALOG
- DROP DATABASE
- DROP CREDENTIAL
- DROP FUNCTION
- DROP LOCATION
- DROP PROVIDER
- DROP RECIPIENT
- DROP SCHEMA
- DROP SHARE
- DROP TABLE
- DROP VIEW
- MSCK REPAIR TABLE
- 同期
- TRUNCATE TABLE
DML ステートメント
データ操作ステートメントを使用して、Delta Lake テーブルのデータの追加、変更、または削除を行います。
- COPY INTO
- DELETE FROM
- INSERT INTO
- INSERT OVERWRITE DIRECTORY
- Hive 形式を使用した INSERT OVERWRITE DIRECTORY
- LOAD DATA
- MERGE INTO
- UPDATE
データ取得ステートメント
クエリを使用して、指定された句に従って 1 つ以上のテーブルから行を取得します。 サポートされている句の完全な構文と簡単な説明については、「クエリ」の記事をご覧ください。
関連する SQL ステートメント SELECT および VALUES もこのセクションに含まれています。
また、Databricks SQL では、EXPLAIN ステートメントを使用して、クエリの論理と物理の各プランを生成することもできます。
Delta Lake のステートメント
Delta Lake SQL ステートメントを使用して、Delta Lake 形式で格納されているテーブルを管理します。
- CACHE SELECT
- CONVERT TO DELTA
- DESCRIBE HISTORY
- FSCK REPAIR TABLE
- GENERATE
- OPTIMIZE
- REORG TABLE
- RESTORE
- VACUUM
Delta Lake ステートメントの使用方法の詳細については、「Delta Lake とは」を参照してください。
補助ステートメント
補助ステートメントを使用して、統計情報の収集、キャッシュの管理、メタデータの探索、構成の設定、リソースの管理を行います。
Analyze ステートメント
Apache Spark Cache ステートメント
適用対象: Databricks Runtime
Describe ステートメント
- DESCRIBE CATALOG
- DESCRIBE CREDENTIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- DESCRIBE LOCATION
- DESCRIBE PROVIDER
- DESCRIBE QUERY
- DESCRIBE RECIPIENT
- DESCRIBE SCHEMA
- DESCRIBE SHARE
- DESCRIBE TABLE
Show ステートメント
- LIST
- SHOW ALL IN SHARE
- SHOW CATALOGS
- SHOW COLUMNS
- SHOW CREATE TABLE
- SHOW CREDENTIALS
- SHOW DATABASES
- SHOW FUNCTIONS
- SHOW GROUPS
- SHOW LOCATIONS
- SHOW PARTITIONS
- SHOW PROVIDERS
- SHOW RECIPIENTS
- SHOW SCHEMAS
- SHOW SHARES
- SHOW SHARES IN PROVIDER
- SHOW TABLE
- SHOW TABLES
- SHOW TBLPROPERTIES
- SHOW USERS
- SHOW VIEWS
構成管理
リソース管理
適用対象: Databricks Runtime
セキュリティ ステートメント
セキュリティ SQL ステートメントを使用して、データへのアクセスを管理します。
- ALTER GROUP
- CREATE GROUP
- DENY
- DROP GROUP
- GRANT
- GRANT SHARE
- REPAIR PRIVILEGES
- REVOKE
- REVOKE SHARE
- SHOW GRANTS
- SHOW GRANTS ON SHARE
- SHOW GRANTS TO RECIPIENT
これらのステートメントの使用方法の詳細については、「データ オブジェクトの特権」を参照してください。