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 17)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 16)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 15)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 14)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 13)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 12)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 11)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 10)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 9.6)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: xmloption
xmloption (PostgreSQL 9.5)
| 设置 | 内容 |
| 单位 | |
| 类别 | 客户端连接默认值/语句行为 |
| 简短描述 | 设置在隐式解析和序列化操作中是否将XML数据视为文档或内容片段。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 枚举 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | content, document |
| 引导值 | 内容 |
| 重置值 | 内容 |
| 源文件 | |
| 源代码行 | |
| 待重启 | false |
文档: 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