OPENXML是SQL Server原生导入XML最直接方式，需用sp_xml_preparedocument加载并声明命名空间，标志位常用2（属性为中心），用后须sp_xml_removedocument释放；大文件应避免VARCHAR(MAX)，改用外部解析或BULK INSERT。
SQL Server 用 OPENXML 导入 XML 数据最直接
SQL Server 原生支持 XML 导入，OPENXML 是最贴近“把 XML 当数据源”来用的方式，尤其适合结构固定、层级不深的 XML 文件。它不依赖外部工具或临时表，全程在 T-SQL 内完成解析与插入。
常见错误现象：sp_xml_preparedocument 返回 NULL 却没检查，后续 OPENXML 报错 “无效的文档句柄”；或者 XML 中有默认命名空间（xmlns="http://..."），但没在 WITH 子句里声明，结果所有字段全为 NULL。
- 必须先调用
sp_xml_preparedocument加载 XML 字符串，返回句柄；用完立刻用sp_xml_removedocument释放，否则内存泄漏 - 若 XML 含命名空间，
WITH子句前需加SELECT * FROM OPENXML(@hdoc, '/root/item', 2) WITH (name VARCHAR(50) '@name')这类路径，且需在sp_xml_preparedocument第二参数传入命名空间声明字符串 -
OPENXML的第三个参数是标志位：1=元素为中心，2=属性为中心，常用 2，否则字段映射容易错位
XML 文件太大时，别硬塞进 VARCHAR(MAX)，改用 FILESTREAM 或 xp_cmdshell + BULK INSERT
当 XML 文件超过几 MB，直接读成 VARCHAR(MAX) 容易触发内存压力，甚至被 SQL Server 截断（尤其含 Unicode 或 BOM 头时）。这时得绕开“全加载再解析”的路子。
使用场景：日志归档 XML、批量导出的业务数据包（如订单集合），文件体积常超 10MB。
- 优先考虑
BULK INSERT配合格式化文件（.fmt）——但前提是 XML 已预处理为带分隔符的文本（如 CSV），否则不适用 - 真正的大 XML，建议用 PowerShell 或 C# 先解析、拆分成行数据，再用
SqlBulkCopy批量写入；SQL Server 本身不擅长流式解析大 XML - 如果必须用 SQL Server 原生方式，可启用
xp_cmdshell调用系统命令读取文件内容到变量，但存在安全风险，生产环境通常禁用
用 SELECT ... FROM @xml.nodes() 更轻量，适合简单嵌套结构
如果 XML 只有一两级嵌套（比如 <orders><order id="1"><item>A</item></order></orders>），.nodes() 方法比 OPENXML 更简洁、无句柄管理负担，性能也更好。
参数差异明显：.nodes() 接 XPath 表达式（如 '/orders/order'），返回虚拟表；.value() 提取值时，路径必须带类型标注（如 '@id[1]' 或 'item[1]'），否则报错。
- 注意
[1]下标是必需的——SQL Server XML 类型要求明确指定单个节点，哪怕你确定只有一个 - 属性提取用
@attr_name，元素内容用text()[1]或直接element_name[1]，混用会返回空 - 如果 XML 中有 CDATA 段或实体编码（如
<），.value()会自动解码，无需额外处理
导入后字段全是 NULL？先查 XML 是否合法、编码是否匹配
90% 的“导入失败”其实卡在前置环节：XML 文件本身不能被 SQL Server 正确识别。不是语法错，而是编码或格式细节踩坑。
典型错误信息：XML parsing: line 1, character 1, unable to switch the encoding；或 Invalid at the top level of the document。
- 用记事本另存为 UTF-8（带 BOM）或 UTF-16，避免 Linux 生成的 UTF-8 无 BOM 被误判
- 检查首行是否有空白字符或不可见控制符（如
0x00），SQL Server 对 XML 输入极其敏感 - 用
SELECT CAST(@xml AS XML)单独测试变量内容是否能转成 XML 类型——这是最快验证 XML 合法性的办法
复杂点在于：同一个 XML 文件，在 SSMS 里执行成功，放到存储过程中就失败。往往是因为存储过程参数类型是 NVARCHAR 但传入了非 Unicode 字符串，或拼接时丢失了转义。这种细节，不打日志很难定位。
