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