Статья
04/01/2012

Установка проверки узла в шаге выражения пути

Шаг оси в выражении пути содержит следующие компоненты:

Ось
Проверка узла
Несколько необязательных квалификаторов шага (или ни одного)

Дополнительные сведения см. в разделе Выражения пути (XQuery).

Проверка узла является условием и вторым компонентом шага оси в выражении пути. Этому условию должны удовлетворять все узлы, выбранные на шаге. Для выражения пути /child::ProductDescription проверкой узла является ProductDescription. Этот шаг получает только потомки узлов элементов с именем ProductDescription.

В условии проверки узла могут быть указаны следующие данные:

Имя узла. Возвращаются только узлы с заданным именем, относящиеся к основному узлу.
Тип узла. Возвращаются только узлы заданного типа.

Примечание
Имена узлов, заданные в выражениях пути XQuery, всегда обрабатываются с учетом регистра и не подчиняются тем же правилам зависимости от параметров сортировки, что и запросы на Transact-SQL.

Имя узла в качестве проверки узла

При указании имени узла в качестве проверки узла в шаге выражения пути необходимо понимать принцип основного узла. У каждой оси, потомка, родителя и атрибута есть основной узел. Например:

Ось атрибутов может содержать только атрибуты. Поэтому узел атрибутов является основным по отношению к оси атрибутов.
Что касается других осей — если выбранные осью узлы могут содержать узлы элементов, то узел элемента является основным для этой оси.

При указании имени узла в качестве проверки узла шаг возвращает следующие типы узлов:

Узлы, являющиеся основными узлами оси.
Узлы с именем, которое задано в проверке узла.

Например, рассмотрим следующее выражение пути:

child::ProductDescription

Это одношаговое выражение задает ось child и имя узла ProductDescription в качестве проверки узла. Выражение возвращает только те узлы с именем ProductDescription, которые являются основными для дочерней оси и узлов элементов.

У выражения пути /child::PD:ProductDescription/child::PD:Features/descendant::*, есть три шага. Они задают дочерние оси и оси потомков. На каждом шаге имя узла задается в качестве проверки узла. Символ-шаблон (*) на третьем шаге задает все узлы главного узла для оси-потомка. Основной узел оси определяет тип выбранных узлов, а имя узла их отфильтровывает.

В результате если выражение выполняется по XML-документам каталога продуктов в таблице ProductModel, оно получает все дочерние элементные узлы узла элемента <Features> для элемента <ProductDescription>.

Выражение узла /child::PD:ProductDescription/attribute::ProductModelID состоит из двух шагов. В обоих имя узла задается в качестве проверки узла. Кроме того, в каждом шаге используется ось атрибутов. Поэтому в каждом шаге выбираются узлы основного узла оси с именем, заданным в качестве проверки узла. Таким образом, выражение возвращает узел атрибутов ProductModelID узла элемента <ProductDescription>.

Как показано в следующем примере, при указании имен узлов для проверки локальное имя узла или префикс его пространства имен можно задавать с помощью символа-шаблона (*):

declare @x xml
set @x = '
<greeting xmlns="ns1">
   <salutation>hello</salutation>
</greeting>
<greeting xmlns="ns2">
   <salutation>welcome</salutation>
</greeting>
<farewell xmlns="ns1" />'
select @x.query('//*:greeting')
select @x.query('declare namespace ns="ns1"; /ns:*')

Тип узла в качестве проверки узла

Для запросов к узлам, не являющимся узлами элементов, используется проверка типа узла. Существует четыре вида проверки типа узла, как показано в следующей таблице:

Тип узла	Возвращает	Пример
comment()	Верно для узла комментариев.	following::comment() выбирает все узлы комментариев, которые появляются после узла контекста.
node()	Верно для всех узлов.	preceding::node() выбирает все узлы, которые появляются перед узлом контекста.
processing-instruction()	Верно для узла инструкций по обработке.	self::processing instruction() выбирает все узлы инструкций по обработке в узле контекста.
text()	Верно для текстового узла.	child::text() выбирает все текстовые узлы, являющиеся потомками узла контекста.

Если в качестве проверки узла задан тип узла, например text() или comment() ..., то шаг возвращает узлы заданного типа независимо от основного узла оси. Например, следующее выражение пути возвращает только потомки узла комментариев к узлу контекста:

child::comment()

Аналогично /child::ProductDescription/child::Features/child::comment() получает потомки узла комментариев к дочернему элементному узлу <Features> узла элемента <ProductDescription>.

Примеры

В следующем примере сравниваются имена и типы узлов.

А. Результаты указания имени и типа узла в качестве проверки узла в выражении пути

В следующем примере переменной типа xml присваивается XML-документ. К этому документу выполняется запрос с помощью разных выражений пути. Результаты сравниваются.

declare @x xml
set @x='
<a>
 <b>text1
   <c>text2
     <d>text3</d>
   </c>
 </b>
</a>'
select @x.query('
/child::a/child::b/descendant::*
')

Это выражение запрашивает узлы элементы-потомки узла элемента <b>.

Звездочка (*) в проверке узла задает символ-шаблон для имени узла. В качестве узла элемента выступает основной узел оси-потомка. Поэтому выражение возвращает все узлы элементов-потомки узла элемента <b>. То есть возвращаются узлы элементов <c> и <d>, как показано в следующем результате:

<c>text2
     <d>text3</d>
</c>
<d>text3</d>

Если вместо оси-потомка задать ось descendent-or-self, то возвращается узел контекста и его потомки.

/child::a/child::b/descendant-or-self::*

Это выражение возвращает узел элемента <b> и его узлы элементов-потомки. При возвращении узлов-потомков основной узел оси descendant-or-self, тип узла элемента, определяет виды возвращаемых узлов.

Результат:

<b>text1
   <c>text2
     <d>text3</d>
   </c>
</b>

<c>text2
     <d>text3</d>
</c>

<d>text3</d>

В предыдущем выражении в качестве имени узла использовался символ-шаблон. Вместо него можно использовать функцию node(), как показано в следующем выражении:

/child::a/child::b/descendant::node()

Поскольку node() является типом узла, будут получены все узлы оси-потомка. Результат:

text1
<c>text2
     <d>text3</d>
</c>
text2
<d>text3</d>
text3

Если в качестве проверки узла задать ось descendant-or-self и node(), то будут получены все потомки, элементы и текстовые узлы, а также узел контекста, элемент <b>.

<b>text1
   <c>text2
     <d>text3</d>
   </c>
</b>
text1
<c>text2
     <d>text3</d>
</c>
text2
<d>text3</d>
text3

Б. Указание имени узла в проверке узла

В следующем примере в качестве проверки узла во всех выражениях пути задается имя узла. В результате все выражения возвращают узлы основного узла оси, имена которых были указаны при проверке узлов.

Следующее выражение запроса возвращает элемент <Warranty> из XML-документа каталога продуктов, который хранится в таблице Production.ProductModel:

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::wm:Warranty
')
FROM Production.ProductModel
WHERE ProductModelID=19

Обратите внимание на следующие данные из предыдущего запроса:

Ключевое слово namespace в прологе XQuery определяет префикс, который используется в теле запроса. Дополнительные сведения о прологе XQuery см. в разделе Пролог XQuery.
Все три шага в выражении пути задают дочернюю ось и имя узла в качестве проверки узла.
Необязательный квалификатор шага не задан ни в одном шаге выражения.

Запрос возвращает дочерние элементы <Warranty> дочернего элемента <Features> элемента <ProductDescription>.

Результат:

<wm:Warranty xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
  <wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
  <wm:Description>parts and labor</wm:Description>
</wm:Warranty>

В следующем запросе выражение пути задает символ-шаблон (*) в проверке узла.

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::*
')
FROM Production.ProductModel
WHERE ProductModelID=19

Этот символ-шаблон задан для имени узла. Таким образом, запрос возвращает все узлы элементов-потомки узла элемента-потомка <Features> узла элемента <ProductDescription>.

Следующий запрос похож на предыдущий, за исключением того, что вместе с символом-шаблоном задано пространство имен. В результате возвращаются все узлы элементов-потомки в этом пространстве имен. Обратите внимание, что элемент <Features> может содержать элементы из разных пространств имен.

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::wm:*
')
FROM Production.ProductModel
WHERE ProductModelID=19

Этот символ-шаблон можно использовать в качестве префикса пространства имен, как показано в следующем запросе:

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::*:Maintenance
')
FROM Production.ProductModel
WHERE ProductModelID=19

Запрос возвращает узлы элементов-потомки <Maintenance> из всех пространств имен XML-документа каталога продуктов.

В. Указание типа узла в качестве проверки узла

В следующем примере в качестве проверки узла во всех выражениях пути задается тип узла. В результате все выражения возвращают узлы того типа, который задан в проверке узла.

В следующем запросе выражение пути в третьем шаге задает тип узла.

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::text()
')
FROM Production.ProductModel
WHERE ProductModelID=19

В следующем запросе указывается следующее:

Выражение пути состоит из трех шагов, разделенных косой чертой (/).
В каждом шаге задается дочерняя ось.
Первые два шага задают имя узла в качестве проверки узла, а на третьем шаге указывается тип узла в качестве проверки узла.
Выражение возвращает текстовые узлы-потомки <Features> дочернего элемента узла элемента <ProductDescription>.

Возвращаются только текстовые узлы. Результат:

These are the product highlights.

Следующий запрос возвращает дочерние узлы комментариев к элементу <ProductDescription>:

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::comment()
')
FROM Production.ProductModel
WHERE ProductModelID=19

Обратите внимание на следующие данные из предыдущего запроса:

Второй шаг задает тип узла в качестве проверки узла.
В результате выражение возвращает дочерние узлы комментариев к узлам элементов <ProductDescription>.

Результат:

<!-- add one or more of these elements... one for each specific product in this product model -->
<!-- add any tags in <specifications> -->

Следующий запрос получает узлы обработки инструкций верхнего уровня:

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::processing-instruction()
')
FROM Production.ProductModel
WHERE ProductModelID=19

Результат:

<?xml-stylesheet href="ProductDescription.xsl" type="text/xsl"?>

Проверке запроса processing-instruction() в качестве параметров можно передавать строковые литералы. В этом случае запрос возвращает инструкции по обработке, для которых значение атрибута имени является строковым литералом, заданным аргументом.

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::processing-instruction("xml-stylesheet")
')
FROM Production.ProductModel
WHERE ProductModelID=19

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

Ниже приводятся особые ограничения.

Проверки узлов расширенного типа SequenceType не поддерживаются.
Формат вида «инструкция_по_обработке(имя)» не поддерживается. Имя следует указывать в кавычках.

Поделиться через

Установка проверки узла в шаге выражения пути

Имя узла в качестве проверки узла

Тип узла в качестве проверки узла

Примеры

А. Результаты указания имени и типа узла в качестве проверки узла в выражении пути

Б. Указание имени узла в проверке узла

В. Указание типа узла в качестве проверки узла

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

Дополнительные ресурсы