与 QName 相关的函数 - expanded-QName
适用于：
SQL Server
返回 xs：QName 类型的值，其中包含 在 $paramURI 中指定的命名空间 URI，以及 $paramLocal中指定的本地名称。 如果 $paramURI 为空字符串或空序列，则它不表示命名空间。
语法
fn:expanded-QName($paramURI as xs:string?, $paramLocal as xs:string?) as xs:QName?
参数
$paramURI
QName 的命名空间 URI。
$paramLocal
QName 的本地名称部分。
注解
以下内容适用于 expanded-QName () 函数：
如果指定的 $paramLocal 值不是 xs：NCName 类型的正确词法形式，则返回空序列并表示动态错误。
SQL Server不支持从 xs：QName 类型转换为任何其他类型。 因此，不能在 XML 构造中使用 expanded-QName () 函数。 例如，当构造节点（如
<e> expanded-QName(...) </e>）时，其值就必须是非类型化的。 这就要求您将expanded-QName()返回的 xs:QName 类型值转换为 xdt:untypedAtomic。 但是，不支持此操作。 在本主题的后面的示例中给出了一种解决方案。您可以修改或比较现有的 QName 类型值。 例如，
/root[1]/e[1] eq expanded-QName("http://nsURI" "myNS")将 元素><e的值与 expanded-QName () 函数返回的 QName 进行比较。
示例
本主题提供针对存储在数据库中各种 xml 类型列中的 XML 实例的 AdventureWorks2022 XQuery 示例。
A. 替换 QName 类型节点值
此示例说明了如何修改 QName 类型的元素节点的值。 该示例执行以下操作：
创建定义 QName 类型的元素的 XML 架构集合。
使用 XML 架构集合创建具有 xml 类型列的表。
将 XML 实例保存在表中。
使用 xml 数据类型的 modify () 方法修改 实例中 QName 类型元素的值。 expanded-QName () 函数用于生成新的 QName 类型值。
-- If XML schema collection (if exists)
-- drop xml schema collection SC
-- go
-- Create XML schema collection
CREATE XML SCHEMA COLLECTION SC AS N'
<schema xmlns="http://www.w3.org/2001/XMLSchema"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="QNameXSD"
xmlns:xqo="QNameXSD" elementFormDefault="qualified">
<element name="Root" type="xqo:rootType" />
<complexType name="rootType">
<sequence minOccurs="1" maxOccurs="1">
<element name="ElemQN" type="xs:QName" />
</sequence>
</complexType>
</schema>'
go
-- Create table.
CREATE TABLE T( XmlCol xml(SC) )
-- Insert sample XML instnace
INSERT INTO T VALUES ('
<Root xmlns="QNameXSD" xmlns:ns="https://myURI">
<ElemQN>ns:someName</ElemQN>
</Root>')
go
-- Verify the insertion
SELECT * from T
go
-- Result
<Root xmlns="QNameXSD" xmlns:ns="https://myURI">
<ElemQN>ns:someName</ElemQN>
</Root>
在以下查询中 <ElemQN> ，使用 xml 数据类型的 modify () 方法和 XML DML 的 replace 值替换元素值，如下所示。
-- the value.
UPDATE T
SET XmlCol.modify('
declare default element namespace "QNameXSD";
replace value of /Root[1]/ElemQN
with expanded-QName("https://myURI", "myLocalName") ')
go
-- Verify the result
SELECT * from T
go
结果如下： 请注意，QName 类型的 元素 <ElemQN> 现在具有一个新值：
<Root xmlns="QNameXSD" xmlns:ns="urn">
<ElemQN xmlns:p1="https://myURI">p1:myLocalName</ElemQN>
</Root>
以下语句删除了用于示例的对象。
-- Cleanup
DROP TABLE T
go
drop xml schema collection SC
go
B. 处理使用 expanded-QName() 函数时的限制。
不能在 XML 构造中使用 expanded-QName 函数。 下面的示例对此进行了演示。 为了消除此限制，该示例首先插入一个节点，然后修改此节点。
-- if exists drop the table T
--drop table T
-- go
-- Create XML schema collection
-- DROP XML SCHEMA COLLECTION SC
-- go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema">
<element name="root" type="QName" nillable="true"/>
</schema>'
go
-- Create table T with a typed xml column (using the XML schema collection)
CREATE TABLE T (xmlCol XML(SC))
go
-- Insert an XML instance.
insert into T values ('<root xmlns:a="https://someURI">a:b</root>')
go
-- Verify
SELECT *
FROM T
以下尝试添加另一个 <root> 元素但失败，因为 XML 构造中不支持 expanded-QName () 函数。
update T SET xmlCol.modify('
insert <root>{expanded-QName("http://ns","someLocalName")}</root> as last into / ')
go
解决方法是先插入具有 元素值的 实例， <root> 然后对其进行修改。 在此示例中，插入元素时 <root> 使用 nil 初始值。 此示例中的 XML 架构集合允许元素的值为 nil <root> 。
update T SET xmlCol.modify('
insert <root xsi:nil="true"/> as last into / ')
go
-- now replace the nil value with another QName.
update T SET xmlCol.modify('
replace value of /root[last()] with expanded-QName("http://ns","someLocalName") ')
go
-- verify
SELECT * FROM T
go
-- result
<root>b</root>
<root xmlns:a="https://someURI">a:b</root>
<root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p1="http://ns">p1:someLocalName</root>
可以比较 QName 值，如以下查询所示。 查询仅 <root> 返回值与 expanded-QName () 函数返回的 QName 类型值匹配的元素。
SELECT xmlCol.query('
for $i in /root
return
if ($i eq expanded-QName("http://ns","someLocalName") ) then
$i
else
()')
FROM T
实现限制
有一个限制： expanded-QName () 函数接受空序列作为第二个参数，并在第二个参数不正确时返回空序列，而不是引发运行时错误。