CONFIGURATION PARAMETER客户端连接默认值 / 语句行为

xmloption

设置在 XML 与字符串值之间进行转换时，隐含采用 DOCUMENT 还是 CONTENT。

Sets whether XML data in implicit parsing and serialization operations is to be considered as documents or content fragments.

枚举会话引入 8.3 现存至 20 devel 0 次默认值变更

类型: 枚举enum
上下文: 会话任何用户都可在会话内用 SET 修改
默认值: content
枚举值: content, document
分类: 客户端连接默认值 / 语句行为
引入版本: 8.3
状态: 现存

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

content 9.0 – 19

已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.11 客户端连接默认值本站手册官方原文

设置在 XML 与字符串值之间进行转换时，隐含采用 DOCUMENT 还是 CONTENT。有关说明参见第 8.13 节。有效值是 DOCUMENT 和 CONTENT。默认值是 CONTENT。

根据 SQL 标准，设置这个选项的命令是：

SET XML OPTION { DOCUMENT | CONTENT };

这种语法在 PostgreSQL 也可用。

机制详解

xmloption：设置隐式解析和序列化 XML 数据时将其视为文档还是内容片段。CONTENT 允许 XML 片段，而 DOCUMENT 要求单个格式良好的 XML 文档，因此会改变隐式转换与序列化行为。

xmloption 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

它改变客户端边界上的表示、解析或区域行为，而不是物理存储。应与其他区域和格式参数，以及驱动的二进制或类型化协议协同考虑。

调优建议

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

OLTP在线事务处理

把 xmloption 视为应用协议，而不是性能旋钮。按角色或连接池统一，并在客户端解析文本时明确固定线格式。
OLAP分析与批处理

为导出、报表与可复现分析任务固定 xmloption；若文件或 API 具有长期模式，优先在 SQL 中显式格式化。
小规格低配实例与开发机

除非客户端明确需要其他取值，否则保留上游或区域派生值；小规格服务器不会因调整 xmloption 获得容量收益。

常见问题

只在一个会话中修改 xmloption，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
误以为显示参数会改变已存储值或服务器端类型语义。
未测试文本解析客户端、导出与池化会话就修改角色或数据库默认值。
没有回滚计划及客户端或运维兼容测试，就全局修改 xmloption。

演化历史

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

PostgreSQL 8.4 ← 8.3 属性变更

类型 字符串 枚举
PostgreSQL 8.3 ← 8.2 新增此参数

PostgreSQL 8.3 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.3	—	—	—	`字符串`	—	—	—
8.4	—	—	—	`枚举`	—	—	—
9.0	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.1	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.2	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.3	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.4	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.5	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
9.6	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
10	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
11	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
12	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
13	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
14	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
15	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
16	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
17	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
18	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
19	`content`	`—`	`会话`	`枚举`	`—`	`—`	`content, document`
20	—	—	—	`枚举`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Client Connection Defaults 客户端连接默认值 28 个 ↗
语句行为 28
`bytea_output`	枚举	会话	`hex`	—
设置 bytea 类型值的输出格式。				现存
`check_function_bodies`	布尔	会话	`on`	—
这个参数通常为打开。				现存
`client_min_messages`	枚举	会话	`notice`	8.41 次
控制被发送给客户端的消息级别。				现存
`createrole_self_grant`	字符串	会话	`空字符串`	—
如果一个拥有 CREATEROLE 但不拥有 SUPERUSER 权限的用户创建了角色，并且此选项被设置为非空值，则新创建的角色将以指定选项授予创建者。				现存
`default_table_access_method`	字符串	会话	`heap`	—
创建表或物化视图时，如果 CREATE 命令没有显式指定访问方法，或者使用了不允许指定表访问方法的 SELECT ...				现存
`default_tablespace`	字符串	会话	`空字符串`	—
这个变量指定当一个 CREATE 命令没有显式指定一个表空间时，创建对象（表和索引）的默认表空间。				现存
`default_toast_compression`	枚举	会话	`pglz`	191 次
这个变量设置可压缩列的值所使用的默认 TOAST 压缩方法。				现存
`default_transaction_deferrable`	布尔	会话	`off`	—
当运行在 serializable 隔离级别时，一个可延迟只读 SQL 事务可能在获准继续之前被延迟一段时间。				现存
`default_transaction_isolation`	枚举	会话	`read committed`	8.41 次
每个 SQL 事务都有一个隔离级别，可以是“读未提交”、“读已提交”、“可重复读”或者“可串行化”。				现存
`default_transaction_read_only`	布尔	会话	`off`	—
一个只读的 SQL 事务不能修改非临时表。				现存
`event_triggers`	布尔	会话（超级用户）	`on`	—
允许临时禁用事件触发器的执行，以便对有故障的事件触发器进行故障排查和修复。				现存
`gin_pending_list_limit`	整数	会话	`4 MiB`	—
设置 fastupdate 被启用时可以使用的 GIN 索引的待处理列表的最大尺寸。				现存
`idle_in_transaction_session_timeout`	整数	会话	`0 ms`	—
终止在打开的事务中空闲（即等待客户端查询）超过指定时长的任何会话。				现存
`idle_session_timeout`	整数	会话	`0 ms`	—
终止不在打开的事务中、且空闲（即等待客户端查询）超过指定时长的任何会话。				现存
`lock_timeout`	整数	会话	`0 ms`	—
如果任何语句在试图获取表、索引、行或其他数据库对象上的锁时等待超过指定的时间量，该语句将被中止。				现存
`restrict_nonsystem_relation_kind`	字符串	会话	`空字符串`	—
设置禁止访问非系统关系的关系类型。				现存
`row_security`	布尔	会话	`on`	—
这个变量控制是否以抛出一个错误来代替应用一条行安全性策略。				现存
`search_path`	字符串	会话	`"$user", public`	9.51 次
这个变量指定当一个对象（表、数据类型、函数等）被用一个无模式限定的简单名称引用时，搜索该对象时的模式顺序。				现存
`session_replication_role`	枚举	会话（超级用户）	`origin`	8.41 次
控制当前会话中复制相关触发器和规则的触发。				现存
`statement_timeout`	整数	会话	`0 ms`	—
中止任何使用了超过指定时间量的语句。				现存
`temp_tablespaces`	字符串	会话	`空字符串`	—
这个变量指定当一个 CREATE 命令没有显式指定一个表空间时，创建临时对象（临时表和临时表上的索引）的默认表空间。				现存
`transaction_deferrable`	布尔	会话	`off`	—
此参数反映当前事务的可延迟性状态。				现存
`transaction_isolation`	枚举	会话	`read committed`	122 次
此参数反映当前事务的隔离级别。				现存
`transaction_read_only`	布尔	会话	`off`	—
此参数反映当前事务的只读状态。				现存
`transaction_timeout`	整数	会话	`0 ms`	—
终止任何在一个事务中运行时间超过指定时长的会话。				现存
`vacuum_cleanup_index_scale_factor`	浮点	会话	`0.1`	—
执行索引清理前插入的元组数量，以 reltuples 的比例表示。				于 14 移除
`xmlbinary`	枚举	会话	`base64`	8.41 次
设置二进制值如何被编码为 XML。				现存
`xmloption`	枚举	会话	`content`	8.41 次
设置在 XML 与字符串值之间进行转换时，隐含采用 DOCUMENT 还是 CONTENT。				现存

快速链接