Выражения пути — указание проверки узла
Применимо к:
SQL Server
Шаг оси в выражении пути содержит следующие компоненты:
Проверка узла
Дополнительные сведения см. в разделе "Выражения пути" (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
B. Указание имени узла при проверке узла
В следующем примере в качестве проверки узла во всех выражениях пути задается имя узла. В результате все выражения возвращают узлы основного узла оси, имена которых были указаны при проверке узлов.
Следующее выражение запроса возвращает <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 Prolog .Все три шага в выражении пути задают дочернюю ось и имя узла в качестве проверки узла.
Необязательный квалификатор шага не задан ни в одном шаге выражения.
Запрос возвращает дочерние <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-документа каталога продуктов.
C. Указание типа узла при проверке узла
В следующем примере в качестве проверки узла во всех выражениях пути задается тип узла. В результате все выражения возвращают узлы того типа, который задан в проверке узла.
В следующем запросе выражение пути в третьем шаге задает тип узла.
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 не поддерживаются.
Формат вида «инструкция_по_обработке(имя)» не поддерживается. Имя следует указывать в кавычках.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по