SQL 语言参考
这是 Databricks SQL 和 Databricks Runtime 的 SQL 命令参考。
若要了解如何将 SQL 与 Delta Live Tables 结合使用,请参阅 Delta Live Tables SQL 语言参考。
注意
Databricks SQL 无服务器在 Azure 中国区域不可用。 Databricks SQL 在 Azure 政府区域不可用。
常规参考
这篇通用参考介绍了数据类型、函数、标识符、文本和语义:
- “适用于”标签
- 如何读懂语法图
- 如何向 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 MATERIALIZED VIEW
- 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
。
通过 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?。
辅助语句
使用辅助语句可以收集统计信息、管理缓存、浏览元数据、设置配置和管理资源:
分析语句
Apache Spark 缓存语句
适用于: Databricks Runtime
描述语句
- 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 RECIPIENT
- SET TIMEZONE
- SET VARIABLE
- USE CATALOG
- USE DATABASE
- USE SCHEMA
资源管理
适用于: Databricks Runtime
适用于:Databricks SQL CLI
安全语句
使用安全 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 元存储特权和安全对象(旧版)。