OPENXML必须先执行sp_xml_preparedocument获取句柄,再调用OPENXML查询,最后用sp_xml_removedocument清理;XML需为NVARCHAR(MAX),flag参数和XPath需匹配节点类型,大文件应改用.nodes()/.value()方法。

OPENXML 用前必须 EXEC sp_xml_preparedocument
SQL Server 的 OPENXML 不是独立函数,而是一个行集函数,依赖前置的文档句柄。没调用 sp_xml_preparedocument 就直接用 OPENXML,会报错:Invalid handle given to OPENXML。
实际流程必须是三步:准备 → 查询 → 清理。漏掉任一环都可能引发内存泄漏或后续调用失败。
-
sp_xml_preparedocument返回一个整数句柄(@hdoc),这个值要原样传给OPENXML - XML 内容必须是
NVARCHAR(MAX)类型;传VARCHAR或截断的字符串会导致解析失败或静默丢数据 - 用完必须显式调用
sp_xml_removedocument @hdoc,尤其在存储过程中,否则句柄累积会耗尽资源
节点映射时要注意 flag 参数和 XPath 路径写法
OPENXML 第三个参数 flag 控制如何匹配节点:0=元素为中心,1=属性为中心,2=混合模式。新手常误设为 0 却按属性方式取值,结果全为 NULL。
同时,XPath 表达式区分大小写,且不支持简写(如 //item 在某些版本下不可靠),推荐用绝对路径或明确层级。
- 想读
中的A id属性,flag必须为 1 或 2,列定义写id @id - 读
的文本内容,A flag用 0,列定义写product VARCHAR(50),对应 XPath 是/order/product - 若 XML 有默认命名空间(如
xmlns="http://tempuri.org/"),必须在sp_xml_preparedocument中声明前缀,否则 XPath 匹配失败
大 XML 文件容易触发内存或超时问题
OPENXML 会把整个 XML 加载进 SQL Server 内存做 DOM 解析,不是流式处理。上传的 XML 超过几 MB 就可能触发 OutOfMemoryException 或查询超时。
这不是配置能绕过的限制,而是架构级约束。生产环境导入大文件应优先考虑替代方案。
网趣购物系统静态版支持网站一键静态生成,采用动态进度条模式生成静态,生成过程更加清晰明确,商品管理上增加淘宝数据包导入功能,与淘宝数据同步更新!采用领先的AJAX+XML相融技术,速度更快更高效!系统进行了大量的实用性更新,如优化核心算法、增加商品图片批量上传、谷歌地图浏览插入等,静态版独特的生成算法技术使静态生成过程可随意掌控,从而可以大大减轻服务器的负担,结合多种强大的SEO优化方式于一体,使
- SQL Server 2005+ 推荐改用原生
.nodes()+.value()方法,性能更好、内存更可控 - 若必须用
OPENXML,需在应用层分片 XML,或限制上传大小(如前端加 2MB 硬限制) - 执行前检查
@xml长度:LEN(@xml) > 2000000就直接 RETURN,避免无谓解析
DECLARE @hdoc INT; DECLARE @xml XML = N''; Laptop EXEC sp_xml_preparedocument @hdoc OUTPUT, @xml;
SELECT * FROM OPENXML(@hdoc, '/orders/order', 2) WITH ( id INT '@id', product VARCHAR(50) 'product' );
EXEC sp_xml_removedocument @hdoc;
OPENXML 不支持嵌套重复结构的自动展开
比如一个订单含多个商品项:,用单次 OPENXML 只能拿到第一层 order,无法直接平铺出多行 item。
这时不能靠调整 flag 或 XPath 解决,必须嵌套调用:先查出 order 句柄,再对每个 items 子树重新 sp_xml_preparedocument —— 但这样极易失控,代码复杂且性能差。
真正可行的做法是放弃 OPENXML,改用 XQuery:@xml.nodes('/orders/order/items/item') 直接定位到叶子节点,再用 .value('@name', 'VARCHAR(50)') 提取。









