xmloption 是一个 配置参数，用于确定在 XML 和字符字符串值之间转换时，DOCUMENT 或 CONTENT 是否隐式。
xmloption 在 PostgreSQL 8.3 中添加。
用法
xmloption 可以设置为以下值之一，以确定如何解析 XML 字符串
CONTENT- 处理格式良好的 XML 片段DOCUMENT- 处理格式良好的 XML 文档
xmloption 也可以使用以下符合 SQL 标准的命令设置
SET XML OPTION { DOCUMENT | CONTENT }
默认值
xmloption 的默认值为：CONTENT。
按 PostgreSQL 版本查看详情
xmloption (PostgreSQL 18)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 17)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 16)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 15)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 14)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 13)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 12)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 11)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 10)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 9.6)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 9.5)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 | |
| 需要重启 | 否 |
文档: xmloption
xmloption (PostgreSQL 9.4)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 9.3)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 9.2)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 9.1)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 9.0)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 8.4)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 启动值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行号 |
文档: xmloption
xmloption (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将 XML 数据视为文档或内容片段。 |
| 额外描述 | 有效值为 DOCUMENT 和 CONTENT。 |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 |
文档: xmloption
更改历史
- PostgreSQL 8.3
- 添加 (提交 8c1de5fb)
示例
xmloption 设置的简单演示
postgres=# SHOW xmloption;
xmloption
-----------
content
(1 row)
postgres=# SELECT '<foo>bar</foo><bar>foo</bar>' IS DOCUMENT;
?column?
----------
f
(1 row)
postgres=# SET xmloption TO document;
SET
postgres=# SELECT '<foo>bar</foo><bar>foo</bar>' IS DOCUMENT;
ERROR: invalid XML document
LINE 1: SELECT '<foo>bar</foo><bar>foo</bar>' IS DOCUMENT;
^
DETAIL: line 1: Extra content at the end of the document
<foo>bar</foo><bar>foo</bar>
^
参考文献
- PostgreSQL 文档： xmloption