这是 Databricks SQL 和 Databricks Runtime 的 SQL 命令参考。
有关将 SQL 与 Lakeflow 声明性管道配合使用的信息，请参阅 Lakeflow 声明性管道 SQL 语言参考。
Note
Databricks SQL 无服务器在 Azure 中国区域不可用。 Databricks SQL 在 Azure 政府区域不可用。
常规参考
这篇通用参考介绍了数据类型、函数、标识符、文本和语义：
- “适用于”标签
- 如何读懂语法图
- 如何向 SQL 语句添加注释
- 配置参数
- 数据类型和字面量
- Functions
- SQL 数据类型规则
- 日期/时间模式
- H3 地理空间函数
- ST 地理空间函数
- Lambda 函数
- 窗口函数
- Identifiers
- Names
- IDENTIFIER 子句
- NULL 语义
- Expressions
- 参数标记
- Variables
- 名称解析
- JSON 路径表达式
- Collation
- Partitions
- Databricks Runtime 中的 ANSI 合规性
- Apache Hive 兼容性
- Principals
- Unity Catalog 中的特权和安全对象
- Hive 元存储中的特权和安全对象
- 刷新 Unity Catalog 元数据
- 外部位置
- 外部表
- Credentials
- Volumes
- SQL 脚本
- 增量共享
- 联合查询（湖屋联合）
- 信息架构
- 保留字
DDL 语句
使用数据定义语句可以创建或修改数据库中数据库对象的结构：
- ALTER CATALOG
- ALTER CONNECTION
- ALTER CREDENTIAL
- ALTER DATABASE
- 修改位置
- ALTER MATERIALIZED VIEW
- ALTER PROVIDER
- ALTER RECIPIENT
- ALTER STREAMING TABLE
- ALTER TABLE
- ALTER SCHEMA
- ALTER SHARE
- ALTER VIEW
- ALTER VOLUME
- COMMENT ON
- 创建布隆过滤器索引
- CREATE CATALOG
- CREATE CONNECTION
- CREATE DATABASE
- CREATE FUNCTION （SQL）
- CREATE FUNCTION（外部）
- 创建位置
- CREATE MATERIALIZED VIEW
- CREATE PROCEDURE
- CREATE RECIPIENT
- CREATE SCHEMA
- CREATE SERVER
- CREATE SHARE
- CREATE STREAMING TABLE
- CREATE TABLE
- CREATE VIEW
- CREATE VOLUME
- DECLARE VARIABLE
- 删除布隆过滤器索引
- 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）
- SET 标记
- SYNC
- TRUNCATE TABLE
- UNDROP TABLE
- UNSET 标记
DML 语句
可以使用数据操作语句从 Delta Lake 表中添加、更改或删除数据：
- COPY INTO
- DELETE FROM
- INSERT 转为
- INSERT OVERWRITE DIRECTORY
- 使用 Hive 格式 的 INSERT OVERWRITE DIRECTORY
- LOAD DATA
- MERGE INTO
- UPDATE
数据检索语句
使用查询可以根据指定的子句检索一个或多个表中的行。
查询文章介绍了支持的子句的完整语法和简要说明。
本部分还包含相关的 SQL 语句 SELECT 和 VALUES。
除了采用 SELECT FROM WHERE样式的标准 SQL 查询外，Azure Databricks 还支持 SQL 管道语法，该语法将 SQL 作为一系列链接操作（如 FROM |> WHERE |> SELECT）组成。
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 语句的详细信息，请参阅 什么是 Azure Databricks 中的 Delta Lake？。
SQL 脚本语句
使用 SQL 脚本在 SQL 中执行过程逻辑。
- CASE 语句
- BEGIN END 复合语句
- FOR 语句
- GETDIAGNOSTICS 语句
- IF THEN ELSE 语句
- ITERATE 语句
- LEAVE 语句
- LOOP 语句
- REPEAT 语句
- RESIGNAL 语句
- SIGNAL 语句
- WHILE 语句
辅助语句
使用辅助语句可以收集统计信息、管理缓存、浏览元数据、设置配置和管理资源：
分析语句
Apache Spark 缓存语句
适用于：
Databricks Runtime
描述语句
- DESCRIBE CATALOG
- DESCRIBE CONNECTION
- DESCRIBE CREDENTIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- 描述位置
- 描述程序
- DESCRIBE PROVIDER
- DESCRIBE QUERY
- DESCRIBE RECIPIENT
- DESCRIBE SCHEMA
- DESCRIBE SHARE
- DESCRIBE TABLE
- DESCRIBE VOLUME
显示语句
- LIST
- SHOW ALL IN SHARE
- SHOW CATALOGS
- SHOW COLUMNS
- SHOW CONNECTIONS
- SHOW CREATE TABLE
- SHOW CREDENTIALS
- SHOW DATABASES
- SHOW FUNCTIONS
- SHOW GROUPS
- 显示位置
- SHOW PARTITIONS
- 展示过程
- SHOW PROVIDERS
- SHOW RECIPIENTS
- SHOW SCHEMAS
- SHOW SHARES
- SHOW SHARES IN PROVIDER
- 显示 TABLE
- SHOW TABLES
- SHOW TABLES DROPPED
- SHOW TBLPROPERTIES
- SHOW USERS
- SHOW VIEWS
- SHOW VOLUMES
配置、变量管理和杂项语句
- CALL
- EXECUTE IMMEDIATE
- RESET
- SET
- SET RECIPIENT
- SET TIMEZONE
- SET VARIABLE
- USE CATALOG
- USE DATABASE
- USE SCHEMA
资源管理
适用于： Databricks Runtime
适用于： Databricks SQL 连接器
安全声明
使用安全 SQL 语句可以管理对数据的访问：
- ALTER GROUP
- CREATE GROUP
- DENY
- DROP GROUP
- GRANT
- GRANT 共享
- 修复特权
- REVOKE
- REVOKE 共享
- SHOW GRANTS
- SHOW GRANTS ON SHARE
- SHOW GRANTS TO RECIPIENT
若要详细了解如何使用这些语句，请参阅 Hive 元存储特权和安全对象（旧版）。