CONFIGURATION PARAMETER版本和平台兼容性 / 以前的 PostgreSQL 版本

array_nulls

允许在数组输入中使用 NULL 元素。

Enables input of NULL elements in arrays.

布尔会话引入 9.0（基线）现存至 20 devel 0 次默认值变更

类型: 布尔bool
上下文: 会话任何用户都可在会话内用 SET 修改
默认值: on
分类: 版本和平台兼容性 / 以前的 PostgreSQL 版本
引入版本: 9.0（基线）
状态: 现存

PostgreSQL 18 手册官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

on 9.0 – 20

默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.13 版本和平台兼容性本站手册官方原文

本版译文与 PostgreSQL 10 完全一致，下面就是同一段文字。

这个参数控制数组输入解析器是否把未用引号的NULL识别为一个空数组元素。默认为on，允许输入包含空值的数组值。但是PostgreSQL 8.2 之前的版本不支持数组中的空值，并且因此将把NULL当作指定一个值为字符串“NULL”的正常数组元素。对于那些要求旧行为的应用的向后兼容性，这个变量可以被设置为off。

注意即使这个变量为off也能够创建包含空值的数组值。

机制详解

允许在数组输入中使用 NULL 元素。它可在会话级修改，因此不同会话可能采用不同的行为。

该兼容开关改变旧客户端或旧 SQL 的解析/输出行为，而不是执行计划的常规性能旋钮。长期方案应修复客户端与 SQL，并在升级测试中移除兼容依赖。

应把 array_nulls 与 backslash_quote、escape_string_warning、standard_conforming_strings 一起监控和变更。先在对应角色与真实负载上验证，再按其 user context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

保持现代默认并修复依赖 array_nulls 的旧客户端/SQL；先在会话级做迁移测试，不要把兼容开关永久设为集群全局策略。
OLAP分析与批处理

重点回归 ETL、生成 SQL 与旧驱动，因为它们常隐藏解析/引用假设；性能差异通常不是调该开关的理由。
小规格低配实例与开发机

没有遗留需求就保持默认。若临时启用，记录责任人、受影响连接与移除日期。

常见问题

把兼容开关当作永久方案而不修复客户端。
只在一个会话测试，却全局部署到所有应用。
混淆解析兼容性与数据或安全兼容性。
升级后忘记清理已经不需要的覆盖。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 18 ← 17 仅描述更新

简述 Enable input of NULL elements in arrays. Enables input of NULL elements in arrays.

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.0	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.1	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.2	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.3	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.4	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.5	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
9.6	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
10	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
11	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
12	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
13	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
14	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
15	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
16	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
17	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
18	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
19	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`
20 沿用	`on`	`—`	`会话`	`布尔`	`—`	`—`	`—`

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Version and Platform Compatibility 版本和平台兼容性 10 个 ↗
以前的 PostgreSQL 版本 10
`array_nulls`	布尔	会话	`on`	—
允许在数组输入中使用 NULL 元素。				现存
`backslash_quote`	枚举	会话	`safe_encoding`	—
设置字符串字面量中是否允许使用反斜杠转义的单引号（\'）。				现存
`default_with_oids`	布尔	会话	`off`	—
默认创建带 OID 的新表。				于 12 移除
`escape_string_warning`	布尔	会话	`on`	—
当普通字符串字面量含反斜杠转义时发出警告。				于 19 移除
`lo_compat_privileges`	布尔	会话（超级用户）	`off`	—
启用大对象权限检查的向后兼容模式。				现存
`operator_precedence_warning`	布尔	会话	`off`	—
对自 PostgreSQL 9.4 起含义发生变化的表达式发出警告。				于 14 移除
`quote_all_identifiers`	布尔	会话	`off`	—
生成 SQL 片段时引用所有标识符。				现存
`sql_inheritance`	布尔	会话	`on`	—
让多种 SQL 命令默认包含继承子表。				于 10 移除
`standard_conforming_strings`	布尔	会话	`on`	9.11 次
使普通单引号字符串中的反斜杠按字面处理。				现存
`synchronize_seqscans`	布尔	会话	`on`	—
启用同步顺序扫描。				现存

快速链接