讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

PostgreSQL的XML数据类型 如何插入和查询XML

落敏大大_9043

落敏大大_9043

发布时间:2026-02-02 11:41:54

|

553人浏览过

|

来源于php中文网

原创

PostgreSQL中XML类型插入需用XMLPARSE(DOCUMENT '...')校验结构,或慎用'...'::xml强制转换;查询用xpath()提取时需索引+::text转换;比较和索引受限,建议冗余字段+表达式索引;导出须xmlserialize避免乱码。

postgresql的xml数据类型 如何插入和查询xml

XML 类型插入必须用 XMLPARSE 或字符串强制转换

PostgreSQL 不允许直接把普通字符串字面量当作 xml 类型插入,否则会报错:cannot cast type text to xml。必须显式解析或转换。

  • 推荐用 XMLPARSE(DOCUMENT '...') —— 它会校验 XML 结构合法性,非法标签或未闭合元素会直接报错
  • 也可用 '<string>'::xml</string> 强制转换,但跳过语法检查,可能存入损坏数据(慎用)
  • 若 XML 内含单引号,需用两个单引号转义:XMLPARSE(DOCUMENT '<user name="" alice></user>')
  • 注意:XMLPARSE(CONTENT '...') 和 DOCUMENT 的区别在于是否允许外部 DTD 或处理指令;日常业务建议用 DOCUMENT
INSERT INTO articles (id, content_xml) 
VALUES (1, XMLPARSE(DOCUMENT '<article><title>PostgreSQL XML</title><body>Use xml data type carefully.</body></article>'));

用 xpath() 提取节点内容要指定命名空间和返回类型

xpath() 是查询 XML 最常用函数,但它返回的是 xml[](XML 数组),不是字符串。直接 SELECT xpath(...) 会看到带花括号的数组输出,容易误判为空。

  • 提取文本值需套一层 (xpath('//title/text()', content_xml))[1] 并用 ::text 转换
  • 如果 XML 带命名空间(如 <rss xmlns="http://purl.org/rss/1.0/"></rss>),必须在 xpath() 第三个参数传入命名空间映射:ARRAY[ARRAY['rss', 'http://purl.org/rss/1.0/']]
  • xpath() 不支持 XPath 2.0 函数(如 lower-case()),仅限 1.0 子集
  • 性能敏感场景避免在 WHERE 中对大 XML 字段频繁调用 xpath(),考虑冗余字段或生成列
SELECT 
  (xpath('//title/text()', content_xml))[1]::text AS title,
  (xpath('//body/text()', content_xml))[1]::text AS body
FROM articles 
WHERE (xpath('//title/text()', content_xml))[1]::text ILIKE '%postgres%';

XML 值比较和索引支持有限,别指望高效 WHERE xml_column = ...

xml 类型支持 = 比较,但实际是按归一化后的字节序列比对:空白、属性顺序、命名空间前缀不同都会导致不等。这意味着看似相同的 XML 可能无法匹配。

  • 无法在 xml 列上创建 B-tree 索引(报错:data type xml has no default operator class)
  • 可用表达式索引加速特定路径查询,例如:CREATE INDEX idx_article_title ON articles USING GIN ((xpath('//title/text()', content_xml)));
  • 更可靠的方式是提取关键字段到普通列(如 title_text TEXT GENERATED ALWAYS AS ((xpath('//title/text()', content_xml))[1]::text) STORED),再建索引
  • XML 值过大(MB 级)会影响 WAL 日志体积和复制延迟,写入前应评估是否真需存完整 XML

导出时用 xmlserialize() 避免意外格式变化

从 xml 列读出的数据默认以内部二进制表示传输,某些客户端(如 psql、某些 ORM)可能显示为乱码或截断。导出为可读字符串必须显式序列化。

  • 用 xmlserialize(content col_name as text) 得到标准 UTF-8 字符串
  • content 表示不带 XML 声明(<?xml version="1.0"?>),用 document 则包含声明
  • 若原始 XML 声明指定了编码(如 encoding="ISO-8859-1"),xmlserialize 仍输出 UTF-8 —— PostgreSQL 内部统一用 UTF-8 存储 XML
  • 不要依赖 CAST(col AS text),它可能返回不可预测的格式(如带换行缩进或无缩进)
SELECT xmlserialize(content content_xml AS text) FROM articles WHERE id = 1;
XML 类型的坑不在语法,而在隐式行为:解析时不校验、查询时返回数组、比较时归一化、索引时无原生支持。真正用起来,往往得靠提前提取字段 + 严格验证输入来兜底。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3591

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

574

2025.10.31

c语言 数据类型
c语言 数据类型

本专题整合了c语言数据类型相关内容,阅读专题下面的文章了解更多详细内容。

602

2026.02.12

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5204

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6777

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2662

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1938

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3224

2023.09.04

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM Programmer’s Manual
LLVM Programmer’s Manual

共0课时 | 0人学习

Conan 包创建教程
Conan 包创建教程

共0课时 | 0人学习

Visual Studio 入门指南
Visual Studio 入门指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn