适用于:
Databricks SQL
配置参数是影响指定 SQL 语法之外的 Databricks SQL 行为的设置。
配置参数的有效值派生自设置的不同级别。
配置参数范围
系统
系统值是在没有替代的情况下 Databricks SQL 使用的默认值。
全球
管理员可使用配置 SQL 参数或 SQL 仓库 API 替代参数的系统默认值。 然后,此值是任何以后新建立的会话看到的初始值。
会话
用户可以用该SET语句覆盖会话期间的配置参数。 有些参数有专用语句,如 SET PATH 或 SET TIME ZONE。 该设置一直有效,直到用户再次覆盖或使用 RESET。
支持的配置参数
以下是可以在 Databricks SQL 中设置的受支持配置参数的列表、其系统默认值以及可以在哪些级别设置这些参数。 Databricks SQL 不支持设置未列出的 Spark 配置。
| 参数名称 | 说明 | 系统默认 | 全局可设置 | 会话可设置 |
|---|---|---|---|---|
| ANSI_MODE | 支持对某些函数和强制转换规则禁用严格的 ANSI SQL 行为。 | 正确 | 是 | 是 |
| LEGACY_TIME_PARSER_POLICY | 控制如何分析和格式化日期和时间戳。 | 例外 | 是 | 是 |
| MAX_FILE_PARTITION_BYTES | 从基于文件的源读取时,要打包到单个分区的最大字节数。 | 128m | 否 | 是 |
| PATH | 设置用于解析未限定名称的模式搜索路径。 | system.session, system.builtin, system.ai, CURRENT_SCHEMA |
是 | 是 |
| READ_ONLY_EXTERNAL_METASTORE | 控制外部元存储是否被视为只读。 | 假 | 是 | 否 |
| STATEMENT_TIMEOUT | 设置 SQL 语句超时(以秒为单位) | 172800 秒 | 是 | 是 |
| TIMEZONE | 设置本地时区。 | UTC | 是 | 是 |
| USE_CACHED_RESULT | 控制 Databricks SQL 是否缓存并尽可能重复使用结果。 | 正确 | 否 | 是 |
ANSI_MODE 系统默认值为 FALSE,适用于在 Databricks SQL 2022.35 之前的版本上添加的帐户。