Freigeben über

  • Artikel

Angeben eines Knotentests in einem Pfadausdrucksschritt

Ein Achsenschritt in einem Pfadausdruck besteht aus den folgenden Komponenten:

Weitere Informationen finden Sie unter Pfadausdrücke (XQuery).

Ein Knotentest ist eine Bedingung und die zweite Komponente eines Achsenschritts in einem Pfadausdruck. Alle von einem Schritt ausgewählten Knoten müssen diese Bedingung erfüllen. Für den Pfadausdruck /child::ProductDescription ist ProductDescription der Knotentest. Dieser Schritt ruft nur die untergeordneten Elementknoten ab, deren Name ProductDescription lautet.

Eine Knotentestbedingung kann Folgendes umfassen:

  • Einen Knotennamen. Nur Knoten der Hauptknotenart mit dem angegebenen Namen werden zurückgegeben.

  • Einen Knotentyp. Nur Knoten des angegebenen Typs werden zurückgegeben.

HinweisHinweis

Für Knotennamen, die in XQuery Pfadausdrücken angegeben werden, gelten nicht die gleichen sortierungsabhängigen Regeln, die für Transact-SQL-Abfragen gelten. Außerdem wird immer Groß- und Kleinschreibung unterschieden.

Knotenname als Knotentest

Wenn Sie einen Knotennamen als Knotentest in einem Schritt eines Pfadausdrucks angeben, sollten Sie das Konzept der Hauptknotenart verstanden haben. Jede Achse (child, parent, attribute und self) verfügt über eine Hauptknotenart. Beispiel:

  • Eine attribute-Achse kann nur Attribute enthalten. Daher ist der attribute-Knoten die Hauptknotenart der attribute-Achse.

  • Für andere Achsen ist element die Hauptknotenart für die betreffende Achse, wenn die von der Achse ausgewählten Knoten element-Knoten enthalten können.

Wenn Sie einen Knotennamen als Knotentest angeben, gibt der Schritt die folgenden Knotentypen zurück:

  • Knoten, die der Hauptknotenart der Achse entsprechen.

  • Knoten, die den gleichen Namen wie im Knotentest angegeben besitzen.

Angenommen, der folgende Pfadausdruck liegt vor:

child::ProductDescription

Dieser Ausdruck mit nur einem Schritt gibt eine child-Achse und den Knotennamen ProductDescription als Knotentest an. Der Ausdruck gibt nur die Knoten zurück, die der Hauptknotenart der child-Achse angehören, element-Knoten und Knoten, die ProductDescription als Namen tragen.

Der Pfadausdruck /child::PD:ProductDescription/child::PD:Features/descendant::*, weist drei Schritte auf. Diese Schritte geben child- und descendant-Achsen an. In jedem Schritt wird der Knotenname als Knotentest angegeben. Das Platzhalterzeichen (*) im dritten Schritt gibt alle Knoten von der Hauptknotenart für die descendant-Achse an. Die Hauptknotenart der Achse bestimmt den Typ der ausgewählten Knoten sowie die Knotennamenfilter, die die Knoten ausgewählt haben.

Wenn dieser Ausdruck für Produktkatalog-XML-Dokumente in der ProductModel-Tabelle ausgeführt wird, werden als Ergebnis alle untergeordneten element-Knoten des untergeordneten <Features>-Elementknotens des <ProductDescription>-Elements abgerufen.

Der Pfadausdruck /child::PD:ProductDescription/attribute::ProductModelID besteht aus zwei Schritten. Beide Schritte geben einen Knotennamen als Knotentest an. Der zweite Schritt verwendet außerdem die attribute-Achse. Daher wählt jeder Schritt Knoten der Hauptknotenart seiner Achse aus, die den Namen als Knotentest angegeben hat. Folglich gibt der Ausdruck den ProductModelID-Attributknoten des <ProductDescription>-Elementknotens zurück.

Wenn Sie die Namen von Knoten für Knotentests angeben, können Sie auch das Platzhalterzeichen (*) zum Angeben des lokalen Namens eines Knotens oder seines Namespacepräfixes verwenden, wie im folgenden Beispiel gezeigt wird:

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:*')

Knotentyp als Knotentest

Um andere Knotentypen als element-Knoten abzufragen, verwenden Sie einen Knotentyptest. Wie in der folgenden Tabelle gezeigt, sind vier Knotentyptests verfügbar.

Knotentyp

Rückgabewert

Beispiel:

comment()

True für einen Kommentarknoten.

following::comment() wählt alle Kommentarknoten aus, die nach dem Kontextknoten auftreten.

node()

True für einen beliebigen Knoten.

preceding::node() wählt alle Kommentarknoten aus, die vor dem Kontextknoten auftreten.

processing-instruction()

True für einen Verarbeitungsanweisungsknoten.

self::processing instruction() wählt alle Verarbeitungsanweisungsknoten im Kontextknoten aus.

text()

True für einen Textknoten.

child::text() wählt alle Textknoten aus, die untergeordnete Elemente des Kontextknotens sind.

Wenn der Knotentyp, z. B. text() oder comment() ..., als Knotentest angegeben wird, gibt der Schritt unabhängig von der Hauptknotenart der Achse nur Knoten der angegebenen Art zurück. Der folgende Pfadausdruck gibt z. B. nur die untergeordneten Kommentarknoten des Kontextknotens zurück:

child::comment()

Entsprechend ruft /child::ProductDescription/child::Features/child::comment() untergeordnete Kommentarknoten des <Features>-Elementknotens des <ProductDescription>-Elementknotens ab.

Beispiele:

Die folgenden Beispiele vergleichen den Knotennamen und die Knotenart.

A. Ergebnisse des Angebens von Knotenname und Knotentyp als Knotentests in einem Pfadausdruck

Im folgenden Beispiel wird ein einfaches XML-Dokument einer Variablen vom Typ xml zugewiesen. Das Dokument wird mithilfe verschiedener Pfadausdrücke abgefragt. Anschließend werden die Ergebnisse verglichen.

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

Dieser Ausdruck fragt die nachfolgenden Elementknoten des <b>-Elementknotens ab.

Das Sternchen (*) im Knotentest zeigt ein Platzhalterzeichen für den Knotennamen an. Die descendant-Achse besitzt den element-Knoten als Hauptknotenart. Daher gibt der Ausdruck alle nachfolgenden Elementknoten des <b>-Elementknotens zurück. Wie im folgenden Beispiel gezeigt, werden die Elementknoten <c> und <d> zurückgegeben:

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

Wenn Sie eine descendant-or-self-Achse statt einer descendant-Achse angeben, werden der Kontextknoten und seine Nachfolger zurückgegeben:

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

Dieser Ausdruck gibt den Elementknoten <b> und seine nachfolgenden Elementknoten zurück. Durch Zurückgeben der nachfolgenden Knoten bestimmt die Hauptknotenart der descendant-or-self-Achse, der Elementknotentyp, welche Arten von Knoten zurückgegeben werden.

Dies ist das Ergebnis:

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

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

<d>text3</d>

Der vorherige Ausdruck verwendete ein Platzhalterzeichen als Knotennamen. Sie können jedoch auch die node()-Funktion wie im folgenden Ausdruck gezeigt verwenden:

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

Da node() ein Knotentyp ist, erhalten Sie alle Knoten der descendant-Achse. Dies ist das Ergebnis:

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

Wenn Sie erneut die descendant-or-self-Achse und node() als Knotentest angeben, erhalten Sie alle Nachfolger, Elemente und Textknoten sowie den Kontextknoten, das <b>-Element.

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

B. Angeben eines Knotennamens im Knotentest

Das folgende Beispiel gibt einen Knotennamen als Knotentest in allen Pfadausdrücken an. Als Ergebnis geben alle Ausdrücke Knoten der Hauptknotenart der Achse zurück, für die der Knotenname im Knotentest angegeben wurde.

Der folgende Abfrageausdruck gibt das <Warranty>-Element aus dem Produktkatalog-XML-Dokument zurück, das in der Production.ProductModel-Tabelle gespeichert ist:

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

Beachten Sie hinsichtlich der vorherigen Abfrage Folgendes:

  • Das namespace-Schlüsselwort im XQuery-Prolog definiert ein Präfix, das im Abfragetext verwendet wird. Weitere Informationen zum XQuery-Prolog finden Sie unter XQuery-Prolog.

  • Alle drei Schritte im Pfadausdruck geben die child-Achse und einen Knotennamen als Knotentest an.

  • Der optionale Schrittbezeichneranteil des Achsenschritts wird in keinem der Schritte im Ausdruck angegeben.

Die Abfrage gibt die untergeordneten <Warranty>-Elemente des untergeordneten <Features>-Elements des <ProductDescription>-Elements zurück.

Dies ist das Ergebnis:

<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>

In der folgenden Abfrage gibt der Pfadausdruck ein Platzhalterzeichen (*) in einem Knotentest an.

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

Das Platzhalterzeichen wird für den Knotennamen angegeben. Daher gibt die Abfrage alle untergeordneten Elementknoten des untergeordneten <Features>-Elementknotens des <ProductDescription>-Elementknotens zurück.

Die folgende Abfrage ähnelt der vorherigen Abfrage; es wird nur ein Namespace zusammen mit dem Platzhalterzeichen angegeben. Als Ergebnis werden alle untergeordneten Elementknoten im betreffenden Namespace zurückgegeben. Beachten Sie, dass das <Features>-Element Elemente aus verschiedenen Namespaces enthalten kann.

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

Sie können das Platzhalterzeichen als Namespacepräfix verwenden, wie in der folgenden Abfrage gezeigt wird:

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

Die Abfrage gibt die untergeordneten <Maintenance>-Elementknoten in allen Namespaces aus dem Produktkatalog XML-Dokument zurück.

B. Angeben der Knotenart im Knotentest

Das folgende Beispiel gibt die Knotenart als Knotentest in allen path-Ausdrücken an. Als Ergebnis geben alle Ausdrücke Knoten der Art zurück, die im Knotentest angegeben wurde.

In der folgenden Abfrage geben die path-Ausdrücke eine Knotenart im dritten Schritt zurück:

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

In der nächsten Abfrage wird Folgendes angegeben:

  • Der Pfadausdruck enthält drei durch einen Schrägstrich (/) getrennte Schritte.

  • Jeder dieser Schritte gibt eine child-Achse an.

  • Die ersten beiden Schritte geben einen Knotennamen als Knotentest an, und der dritte Schritt gibt eine Knotenart als Knotentest an.

  • Der Ausdruck gibt die untergeordneten Textknoten des untergeordneten <Features>-Elements des <ProductDescription>-Elementknotens zurück.

Es wird nur ein Textknoten zurückgegeben. Dies ist das Ergebnis:

These are the product highlights.

Die folgende Abfrage gibt die untergeordneten Kommentarknoten des <ProductDescription>-Elements zurück.

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

Beachten Sie hinsichtlich der vorherigen Abfrage Folgendes:

  • Der zweite Schritt gibt eine Knotenart als Knotentest an.

  • Als Ergebnis gibt der Ausdruck die untergeordneten Kommentarknoten des <ProductDescription>-Elements zurück.

Dies ist das Ergebnis:

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

Die folgende Abfrage ruft die Verarbeitungsanweisungsknoten der obersten Ebene ab:

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

Dies ist das Ergebnis:

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

Sie können einen Zeichenfolgenliteral-Parameter an den processing-instruction()-Knotentest übergeben. In diesem Fall gibt die Abfrage die Verarbeitungsanweisungen zurück, deren Attributwert das Zeichenfolgenliteral ist, das im Argument angegeben wird.

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

Implementierungseinschränkungen

Die folgenden spezifischen Einschränkungen sind zu beachten:

  • Die erweiterten SequenceType-Knotentests werden nicht unterstützt.

  • processing-instruction(name) wird nicht unterstützt. Schließen Sie den Namen stattdessen in Anführungszeichen ein.