适用于: Databricks SQL
 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 之前的版本上添加的帐户。