配置参数

  • 项目

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

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

配置参数范围

  • 系统

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

  • 全球

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

  • 会话

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

支持的配置参数

下面是可在 Databricks SQL 中设置的配置参数、其系统默认值以及可以设置的级别的列表：

参数名称 说明 系统默认 全局可设置 会话可设置
ANSI_MODE 支持对某些函数和强制转换规则禁用严格的 ANSI SQL 行为。 FALSE 是 是
ENABLE_PHOTON 控制 Photon 矢量化查询引擎的使用。 TRUE 否 是
LEGACY_TIME_PARSER_POLICY 控制如何分析和格式化日期和时间戳。 已更正 是 是
MAX_PARTITION_BYTES 从基于文件的源读取时，要打包到单个分区的最大字节数。 128m 否 是
READ_ONLY_EXTERNAL_METASTORE 控制外部元存储是否被视为只读。 FALSE 是 否
TIMEZONE 设置本地时区。 UTC 是 是
USE_CACHED_RESULT 控制 Databricks SQL 是否缓存并尽可能重复使用结果。 TRUE 否 是