在SQL Server中,OpenXML函数能够将XML文档在内存中映射为关系型行集,使开发者可以像查询普通表一样读取XML中的数据。它常与sp_xml_preparedocument和sp_xml_removedocument系统存储过程配合使用,在存储过程中解析传入的XML参数非常实用。

OpenXML基本使用步骤
使用OpenXML解析XML通常包含三个步骤:准备XML文档、执行OpenXML查询、释放文档句柄。下面是一个在存储过程中解析XML参数的简单示例。
CREATE PROCEDURE usp_InsertUsers
@XmlData XML
AS
BEGIN
DECLARE @DocHandle INT
-- 将XML准备到内存并获取句柄
EXEC sp_xml_preparedocument @DocHandle OUTPUT, @XmlData
-- 使用OpenXML读取数据并插入表
INSERT INTO Users (UserName, Age)
SELECT UserName, Age
FROM OPENXML(@DocHandle, '/Root/User', 2)
WITH (
UserName NVARCHAR(50) 'UserName',
Age INT 'Age'
)
-- 释放内存中的XML文档
EXEC sp_xml_removedocument @DocHandle
END
WITH子句与映射模式
OpenXML的WITH子句用于定义输出行集的结构。其中第三个参数表示映射模式:0为属性中心,1为元素中心,2为混合模式。上面的例子使用2,表示同时支持属性和子元素。
XML参数示例
调用上述存储过程时,可以传入如下格式的XML:
<Root>
<User>
<UserName>张三</UserName>
<Age>28</Age>
</User>
<User>
<UserName>李四</UserName>
<Age>34</Age>
</User>
</Root>
注意事项
- 每次调用sp_xml_preparedocument后都必须调用sp_xml_removedocument,否则会造成内存泄漏。
- WITH子句中列的路径要与XML节点名称一致,且数据类型需匹配,避免转换错误。
- 如果XML较大,OpenXML会占用较多内存,应考虑是否使用SQL Server原生的XML方法如nodes()替代。
与原生XML方法对比
除了OpenXML,SQL Server也支持使用xml数据类型的nodes()和value()方法进行解析。下表简要对比两者特点:
| 方式 | 优点 | 缺点 |
|---|---|---|
| OpenXML | 语法直观,早期版本兼容好 | 需手动管理内存句柄 |
| nodes() | 无需句柄,集成于XML类型 | 复杂结构写法稍繁琐 |
在实际存储过程开发中,若系统版本支持,推荐优先评估原生XML方法;但在维护旧项目时,掌握OpenXML函数用法依然十分重要。
SQL_ServerOpenXML存储过程修改时间:2026-07-30 17:24:21