配置参数

适用于:勾选“是” Databricks SQL

配置参数是影响指定 SQL 语法之外的 Databricks SQL 行为的设置。

配置参数的有效值派生自设置的不同级别。

配置参数范围

  • 系统

    系统值是在没有替代的情况下 Databricks SQL 使用的默认值。

  • 全球

    管理员可使用配置 SQL 参数SQL 仓库 API 替代参数的系统默认值。 然后,此值是任何以后新建立的会话看到的初始值。

  • 会话

    用户可以使用 SET 语句在会话范围内临时替代配置参数。 除非用户再次使用 SET 语句RESET 替代,否则该设置在会话期间内保持有效。

支持的配置参数

以下是可以在 Databricks SQL 中设置的受支持配置参数的列表、其系统默认值以及可以在哪些级别设置这些参数。 Databricks SQL 不支持设置未列出的 Spark 配置。

参数名称 说明 系统默认 全局可设置 会话可设置
ANSI_MODE 支持对某些函数和强制转换规则禁用严格的 ANSI SQL 行为。 TRUE
ENABLE_PHOTON 控制 Photon 矢量化查询引擎的使用。 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 之前的版本上添加的帐户。