1、sp_xml_preparedocument与sp_xml_removedocument
(1)sp_xml_preparedocument返回可用于访问新创建的内部表示形式的 XML 文档的句柄。
sp_xml_preparedocument
hdoc OUTPUT
[ , xmltext ]
[ , xpath_namespaces ]
hdoc
新建文档的句柄。 hdoc是一个整数。
[ xmltext ]
是原来的 XML 文档。
[ xpath_namespaces ]
指定在 OPENXML 的行和列 XPath 表达式中使用的命名空间声明。未指定将使用默认的命名空间前缀映射。
(2)sp_xml_removedocument删除文档句柄指定的 XML 文档的内部表示形式并使该文档句柄无效。
sp_xml_removedocument hdoc
hdoc
新建文档的句柄。
2、OPENXML
OPENXML用来解析sp_xml_preparedocument获取的XML句柄。
OPENXML( idoc int [ in] , rowpattern nvarchar [ in ] , [ flags byte [ in ] ] )
[ WITH ( SchemaDeclaration | TableName ) ]
idoc
XML 文档的内部表式形式的文档句柄。 通过调用 sp_xml_preparedocument 创建 XML 文档的内部表式形式。
rowpattern
XPath 模式,用来标识要作为行处理的节点(这些节点在 XML 文档中,该文档的句柄由 idoc 参数传递)。
flag
指示应在 XML 数据和关系行集间使用映射以及应如何填充溢出列。 flag 为可选输入参数,可以是下列值之一。
字节值 | 描述 |
---|---|
0 | 默认为“以属性为中心”的映射。 |
1 | 使用“以属性为中心”的映射。 可以与 XML_ELEMENTS 一起使用。 这种情况下,首先应用“以属性为中心”的映射,然后对所有未处理的列应用“以元素为中心”的映射。 |
2 | 使用“以元素为中心”的映射。 可以与 XML_ATTRIBUTES 一起使用。 这种情况下,首先应用“以属性为中心”的映射,然后对所有未处理的列应用“以元素为中心”的映射。 |
8 | 可与 XML_ATTRIBUTES 或 XML_ELEMENTS 组合使用(逻辑或)。 在检索上下文中,此标记指明不得将已用数据复制到溢出属性 @mp:xmltext。 |
SchemaDeclaration
是窗体的架构定义:ColNameColType [ColPattern | MetaProperty] [,ColNameColType [* ColPattern* | MetaProperty]...]
- ColName
- 行集中的列名。
- ColType
- 行集中列的 SQL Server 数据类型。 如果列类型不同于属性的基础 xml 数据类型,则将发生类型强制。
- ColPattern
- 可选的通用 XPath 模式,它说明应如何将 XML 节点映射到列。 如果没有指定 ColPattern,则发生默认映射(由 flag 指定的“以属性为中心”或“以元素为中心”的映射)。指定为 ColPattern 的 XPath 模式用于指定特殊的映射性质(如果发生“以属性为中心”和“以元素为中心”的映射),这些特殊的映射性质可以重写或增强由 flag 所指示的默认映射。指定为 ColPattern 的通用 XPath 模式也支持元属性。
- MetaProperty
- 由 OPENXML 提供的元属性之一。 如果指定 MetaProperty,则该列包含元属性提供的信息。 使用元属性可以提取有关 XML 节点的信息(如相对位置和命名空间信息)。 它提供了比文本表示形式更详细的信息。
TableName
如果具有所需架构的表已经存在且不要求列模式,则为给定的表名(而不是 SchemaDeclaration)。
3、实例
(1)XML内容
DECLARE @xmlResult XML
--XML句柄
DECLARE @docHandle INT
SET @xmlResult=N'<ImgLabelPointRootXml>
<Imgs>
<ImgLabelPointModel photoid="105BDF53-1DF2-4C7D-B058-4CDB9A8BA152" isvalid="1">
<photoid>105BDF53-1DF2-4C7D-B058-4CDB9A8BA152</photoid>
<isvalid>1</isvalid>
<status>1</status>
<height>400.123</height>
<Width>299.84</Width>
<InitHeight>2580.00</InitHeight>
<CheckDetailId p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
</ImgLabelPointModel>
<ImgLabelPointModel photoid="AA001EAC-8AAC-4D08-98BC-82F27C0CBD73" isvalid="1">
<photoid>AA001EAC-8AAC-4D08-98BC-82F27C0CBD73</photoid>
<isvalid>1</isvalid>
<status>0</status>
<height p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<Width p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<InitHeight p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<CheckDetailId>100012004</CheckDetailId>
</ImgLabelPointModel>
</Imgs>
<Points>
<ImgLabelPointBoxModel skucode="600152" top="210.28">
<skucode>600152</skucode>
<top>210.28</top>
<left>143.39</left>
<CheckDetailId p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<SameGuid>5B07D255-E0FA-4A00-80B7-AA4BD4E43AD0</SameGuid>
<photoid>105BDF53-1DF2-4C7D-B058-4CDB9A8BA152</photoid>
</ImgLabelPointBoxModel>
<ImgLabelPointBoxModel skucode="600153" top="210.75">
<skucode>600153</skucode>
<top>210.75</top>
<left>103.45</left>
<CheckDetailId p4:nil="true" xmlns:p4="http://www.w3.org/2001/XMLSchema-instance" />
<SameGuid>5D809A5D-5D11-4689-A96E-68891D63D8F0</SameGuid>
<photoid>105BDF53-1DF2-4C7D-B058-4CDB9A8BA152</photoid>
</ImgLabelPointBoxModel>
</Points>
</ImgLabelPointRootXml>'
表结构
CREATE TABLE #tempImgs(
photoid VARCHAR(50),
isvalid INT ,
status INT,
height DECIMAL(10,6),
--Width DECIMAL(10,6),
--InitHeight DECIMAL(10,6),
CheckDetailId INT
)
CREATE TABLE #tempPoints(
skucode INT ,
[top] DECIMAL(10,6),
[left] DECIMAL(10,6),
--CheckDetailId INT,
SameGuid VARCHAR(50),
photoid VARCHAR(50)
)
(2)按元素获取
EXEC sp_xml_preparedocument @docHandle OUTPUT,@xmlResult
INSERT INTO #tempPoints
SELECT * FROM OPENXML(@docHandle,'/ImgLabelPointRootXml/Points/ImgLabelPointBoxModel',2)
WITH #tempPoints
SELECT * FROM #tempPoints
(3)按属性获取
EXEC sp_xml_preparedocument @docHandle OUTPUT,@xmlResult
INSERT INTO #tempPoints
SELECT * FROM OPENXML(@docHandle,'/ImgLabelPointRootXml/Points/ImgLabelPointBoxModel',1)
WITH #tempPoints
(4)指定XPath混合获取
EXEC sp_xml_preparedocument @docHandle OUTPUT,@xmlResult
INSERT INTO #tempPoints
SELECT * FROM OPENXML(@docHandle,'/ImgLabelPointRootXml/Points/ImgLabelPointBoxModel',1)
WITH (
skucode INT ,
[top] DECIMAL(10,6),
[left] DECIMAL(10,6) 'left',
SameGuid VARCHAR(50) 'SameGuid',
photoid VARCHAR(50) 'photoid'
)
格式如下
属性:'@ProductID' '../@OrderDate'
元素:'OrderID'
4、注意事项
(1)转换格式失败需要配合SchemaDeclaration使用,如 Error converting data type nvarchar to numeric in XML data retrieving
----类型转换失败的问题先通过with指定兼容的类型,select再转换
EXEC sp_xml_preparedocument @docHandle OUTPUT,@xmlResult
INSERT INTO #tempImgs
SELECT photoid,isvalid,status,CASE WHEN ISNUMERIC(height)=1 THEN CAST(height AS DECIMAL(10,6)) ELSE 0 END,CheckDetailId FROM OPENXML(@docHandle,'/ImgLabelPointRootXml/Imgs/ImgLabelPointModel',2)
WITH (photoid VARCHAR(50),isvalid INT ,status INT,height varchar(20),CheckDetailId INT )
参考:
sp_xml_preparedocument (Transact-SQL)
OPENXML (Transact-SQL)
https://docs.microsoft.com/zh-cn/sql/t-sql/functions/openxml-transact-sql?view=sql-server-2017
使用sp_xml_preparedocument处理XML文档
https://www.cnblogs.com/oec2003/archive/2011/07/23/2742014.html