SQL 语言参考

这是 Databricks SQL 和 Databricks Runtime 的 SQL 命令参考。

若要了解如何将 SQL 与 Delta Live Tables 结合使用，请参阅 Delta Live Tables SQL 语言参考。

常规参考

这篇通用参考介绍了数据类型、函数、标识符、文本和语义：

• “适用于”标签
• 如何读懂语法图
• 如何向 SQL 语句添加注释
• 配置参数
• 数据类型和字面量
• 函数
• SQL 数据类型规则
• 日期/时间模式
• H3 地理空间函数
• Lambda 函数
• 开窗函数
• 标识符
• 名称
• IDENTIFIER 子句
• NULL 语义
• 表达式
• 参数标记
• 变量
• 名称解析
• JSON 路径表达式
• 分区
• Databricks Runtime 中的 ANSI 合规性
• Apache Hive 兼容性
• 主体
• Unity Catalog 中的特权和安全对象
• Hive 元存储中的特权和安全对象
• 刷新 Unity Catalog 元数据
• 外部位置
• 外部表
• 存储凭据
• 卷
• 增量共享
• 联合查询（湖屋联合）
• 信息架构
• 保留字

DDL 语句

使用数据定义语句可以创建或修改数据库中数据库对象的结构：

• ALTER CATALOG

• ALTER CONNECTION

• ALTER CREDENTIAL

• ALTER DATABASE

• ALTER LOCATION

• ALTER PROVIDER

• ALTER RECIPIENT

• ALTER STREAMING TABLE

• ALTER TABLE

• ALTER SCHEMA

• ALTER SHARE

• ALTER VIEW

• ALTER VOLUME

• 评论

• CREATE BLOOMFILTER INDEX

• CREATE CATALOG

• 创建连接

• CREATE DATABASE

• CREATE FUNCTION (SQL)

• CREATE FUNCTION（外部）

• CREATE LOCATION

• CREATE MATERIALIZED VIEW

• CREATE RECIPIENT

• CREATE SCHEMA

• 创建服务器

• CREATE SHARE

• CREATE STREAMING TABLE

• CREATE TABLE

• CREATE VIEW

• 创建卷

• DECLARE VARIABLE

• DROP BLOOMFILTER INDEX

• DROP CATALOG

• DROP CONNECTION

• DROP DATABASE

• DROP CREDENTIAL

• .DROP FUNCTION

• DROP LOCATION

• DROP PROVIDER

• DROP RECIPIENT

• DROP SCHEMA

• DROP SHARE

• DROP TABLE

• DROP VARIABLE

• DROP VIEW

• DROP VOLUME

• MSCK REPAIR TABLE

• REFRESH FOREIGN（CATALOG、SCHEMA 或 TABLE）

• REFRESH（MATERIALIZED VIEW 或 STREAMING TABLE）

• 同步

• TRUNCATE TABLE

• UNDROP TABLE

DML 语句

可以使用数据操作语句从 Delta Lake 表中添加、更改或删除数据：

• COPY INTO
• DELETE FROM
• INSERT INTO
• INSERT OVERWRITE DIRECTORY
• INSERT OVERWRITE DIRECTORY with Hive format
• LOAD DATA
• MERGE INTO
• UPDATE

数据检索语句

使用查询可以根据指定的子句检索一个或多个表中的行。 查询一文中解释了受支持子句的完整语法和简要说明。 本部分还包含相关的 SQL 语句 SELECT 和 VALUES。

• 查询
• SELECT
• VALUES

通过 Databricks SQL 还可以使用 EXPLAIN 语句生成查询的逻辑和物理计划。

• 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？。

辅助语句

使用辅助语句可以收集统计信息、管理缓存、浏览元数据、设置配置和管理资源：

• 分析语句
• Apache Spark 缓存语句
• 描述语句
• 显示语句
• 配置、变量管理和杂项语句
• 资源管理

分析语句

• ANALYZE TABLE

Apache Spark 缓存语句

适用于： Databricks Runtime

• CACHE TABLE
• CLEAR CACHE
• REFRESH CACHE
• REFRESH FUNCTION
• REFRESH TABLE
• UNCACHE TABLE

描述语句

• DESCRIBE CATALOG
• 描述连接
• DESCRIBE CREDENTIAL
• DESCRIBE DATABASE
• DESCRIBE FUNCTION
• DESCRIBE LOCATION
• DESCRIBE PROVIDER
• DESCRIBE QUERY
• DESCRIBE RECIPIENT
• DESCRIBE SCHEMA
• DESCRIBE SHARE
• DESCRIBE TABLE
• DESCRIBE VOLUME

显示语句

• 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 TABLES DROPPED
• SHOW TBLPROPERTIES
• SHOW USERS
• SHOW VIEWS
• SHOW VOLUMES

配置、变量管理和杂项语句

• EXECUTE IMMEDIATE
• RESET
• SET
• SET TIMEZONE
• SET VARIABLE
• USE CATALOG
• USE DATABASE
• USE SCHEMA

资源管理

适用于： Databricks Runtime

• ADD ARCHIVE
• ADD FILE
• ADD JAR
• LIST ARCHIVE
• LIST FILE
• LIST JAR

适用于：Databricks SQL CLI

• GET
• PUT INTO
• REMOVE

安全语句

使用安全 SQL 语句可以管理对数据的访问：

• ALTER GROUP
• CREATE GROUP
• DENY
• DROP GROUP
• GRANT
• GRANT SHARE
• 修复特权
• REVOKE
• REVOKE SHARE
• SHOW GRANTS
• SHOW GRANTS ON SHARE
• SHOW GRANTS TO RECIPIENT

若要详细了解如何使用这些语句，请参阅 Hive 元存储特权和安全对象（旧版）。