Definizione del test di nodo in un passo dell'espressione di percorso

Nell'esempio seguente, un documento XML semplice viene assegnato a una variabile di tipo xml. Vengono eseguite query sul documento tramite espressioni di percorso diverse. Successivamente, vengono confrontati i risultati.

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

Questa espressione chiede i nodi elemento discendenti del nodo elemento <b>.

L'asterisco (*) nel test di nodo indica un carattere jolly per il nome di nodo. Il tipo di nodo primario per l'asse descendant è il nodo elemento. Pertanto, l'espressione restituisce tutti i nodi elemento discendenti del nodo elemento <b>, ovvero vengono restituiti <c> e <d>, come illustrato nel risultato seguente:

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

Se si specifica un asse descendent-or-self anziché un asse descendant, vengono restituiti sia il nodo di contesto che i relativi discendenti:

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

Questa espressione restituisce il nodo elemento <b> e i relativi nodi elemento discendenti. Il tipo di nodi restituiti è determinato dal tipo di nodo primario element dell'asse descendant-or-self, che restituisce infatti i nodi discendenti.

Risultato:

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

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

<d>text3</d> 

Nell'espressione precedente viene utilizzato un carattere jolly come nome di nodo. In alternativa, è possibile utilizzare la funzione node(), come illustrato nell'espressione seguente:

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

Poiché node() è un tipo di nodo, verranno restituiti tutti i nodi dell'asse descendant. Risultato:

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

Analogamente, se si specifica un asse descendant-or-self e node() come test di nodo, verranno restituiti tutti i discendenti, gli elementi e i nodi di testo, nonché il nodo di contesto, ovvero l'elemento <b>.

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

Nell'esempio seguente viene specificato un nome di nodo come test di nodo in tutte le espressioni di percorso. Di conseguenza, tutte le espressioni restituiscono nodi del tipo di nodo principale dell'asse che include il nome di nodo specificato nel test di nodo.

L'espressione di query seguente restituisce l'elemento <Warranty> dal documento XML del catalogo prodotti archiviato nella tabella 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

Dalla query precedente si noti quanto segue:

• La parola chiave namespace nel prologo XQuery definisce un prefisso utilizzato nel corpo della query. Per ulteriori informazioni sul prologo XQuery, vedere Prologo di una query XQuery.

• Tutti e tre i passi nell'espressione di percorso specificano l'asse child e un nome di nodo come test di nodo.

• La parte facoltativa relativa al qualificatore di passo del passo dell'asse non viene specificata nei passi dell'espressione.

La query restituisce gli elementi figlio <Warranty> dell'elemento figlio <Features> dell'elemento <ProductDescription>.

Risultato:

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

Nella query seguente, l'espressione di percorso specifica un carattere jolly (*) in un test di nodo.

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

Il carattere jolly viene specificato per il nome di nodo. Di conseguenza, la query restituisce tutti i nodi elemento figlio <Features> del nodo elemento figlio del nodo elemento <ProductDescription>.

La query seguente è simile alla precedente tranne per il fatto che, insieme al carattere jolly, viene specificato uno spazio dei nomi. Di conseguenza, vengono restituiti tutti i nodi elemento figlio in tale spazio dei nomi. Si noti che l'elemento <Features> può contenere elementi di spazi dei nomi diversi.

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

È possibile utilizzare il carattere jolly come prefisso dello spazio dei nomi, come illustrato nella query seguente:

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

Questa query restituisce i nodi elemento figlio <Maintenance> in tutti gli spazi dei nomi dal documento XML del catalogo prodotti.

Nell'esempio seguente viene specificato il tipo di nodo come test di nodo in tutte le espressioni di percorso. Di conseguenza, tutte le espressioni restituiscono nodi del tipo specificato nel test di nodo.

Nella query seguente, l'espressione di percorso specifica un tipo di nodo nel terzo passo:

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

Nella query successiva, viene specificato quanto segue:

• L'espressione di percorso include tre passi separati da una barra (/).

• Ognuno di questi passi specifica un asse child.

• I primi due passi specificano un nome di nodo come test di nodo, mentre il terzo passo specifica un tipo di nodo come test di nodo.

• L'espressione restituisce i nodi di testo figlio dell'elemento figlio <Features> del nodo elemento <ProductDescription>.

Viene restituito solo un nodo di testo. Risultato:

These are the product highlights. 

La query seguente restituisce i nodi di commento figlio dell'elemento <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

Dalla query precedente si noti quanto segue:

• Il secondo passo specifica un tipo di nodo come test di nodo.

• Di conseguenza, l'espressione restituisce i nodi di commento figlio dei nodi elemento <ProductDescription>.

Risultato:

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

La query seguente recupera i nodi di istruzioni di elaborazione di livello principale:

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

Risultato:

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

È possibile passare un parametro letterale stringa al test di nodo processing-instruction(). In tal caso, la query restituisce le istruzioni di elaborazione per le quali il valore dell'attributo name è il valore letterale stringa specificato nell'argomento.

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