Функции с узлами — namespace-uri

Мақала
05/23/2023

Применимо к:SQL Server

Возвращает URI пространства имен для QName, указанного в $arg в виде xs:string.

Синтаксис

fn:namespace-uri() as xs:string  
fn:namespace-uri($arg as node()?) as xs:string

Аргументы

$arg
Имя узла, для которого будет получена часть URI-кода пространства имен.

Замечания

Если аргумент опускается, значением по умолчанию является узел контекста.
В SQL Server fn:namespace-uri() без аргумента можно использовать только в контексте предиката, зависяющего от контекста. Точнее, она может использоваться только внутри квадратных скобок ([ ]).
Если $arg пустая последовательность, возвращается строка нулевой длины.
Если $arg является элементом или узлом атрибута, развернутый QName которого не находится в пространстве имен, функция возвращает строку нулевой длины.

Примеры

В этом разделе приведены примеры XQuery для экземпляров XML, хранящихся в различных столбцах типов XML в базе данных AdventureWorks.

О. Получение URI-адреса пространства имен определенного узла

Следующий запрос обращается к нетипизированному экземпляру XML. В выражении запроса выражение namespace-uri(/ROOT[1]) получает часть URI-кода пространства имен указанного узла.

set @x='<ROOT><a>111</a></ROOT>'  
SELECT @x.query('namespace-uri(/ROOT[1])')

Так как указанное имя QName не содержит части URI-кода пространства имен, а только часть локального имени, результатом будет строка нулевой длины.

Следующий запрос указан в столбце "Инструкции" с типизированным xml-столбцом. Выражение namespace-uri(/AWMI:root[1]/AWMI:Location[1])возвращает универсальный код ресурса (URI) пространства имен первогоLocation><дочернего <root> элемента элемента элемента.

SELECT Instructions.query('  
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions" ;  
     namespace-uri(/AWMI:root[1]/AWMI:Location[1])') as Result  
FROM Production.ProductModel  
WHERE ProductModelID=7

Результат:

https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions

B. Использование функции namespace-uri() без аргумента в предикате

Следующий запрос указывается в типизированном столбце xml типа CatalogDescription. Выражение возвращает все узлы элементов, чей URI-код пространства имен является адресом https://www.adventure-works.com/schemas/OtherFeatures. Функция namespace-uri() указывается без аргумента и использует узел контекста.

SELECT CatalogDescription.query('  
declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
   /p1:ProductDescription//*[namespace-uri() = "https://www.adventure-works.com/schemas/OtherFeatures"]  
') as Result  
FROM Production.ProductModel  
WHERE ProductModelID=19

Частичный результат:

<p1:wheel xmlns:p1="https://www.adventure-works.com/schemas/OtherFeatures">High performance wheels.</p1:wheel>  
<p2:saddle xmlns:p2="https://www.adventure-works.com/schemas/OtherFeatures">  
  <p3:i xmlns:p3="http://www.w3.org/1999/xhtml">Anatomic design</p3:i> and made from durable leather for a full-day of riding in comfort.</p2:saddle>  
...

Пространство имен URI в предыдущем запросе можно изменить на адрес https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain. Затем вы получите все дочерние <ProductDescription> элементы элемента элемента, URI пространства имен которых является https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMainчастью развернутого QName.

Ограничения реализации

Существуют следующие ограничения:

Функция namespace-uri() возвращает экземпляры типа xs:string вместо xs:anyURI.

См. также

Функции на узлах
Функция локального имени (XQuery)

Бөлісу құралы: