Funzioni di accesso dati - string (XQuery)

Articolo
08/21/2023

Si applica a:SQL Server

Restituisce il valore di $arg rappresentato come stringa.

Sintassi

  
fn:string() as xs:string  
fn:string($arg as item()?) as xs:string

Argomenti

$arg
È un nodo o un valore atomico.

Osservazioni:

Se $arg è la sequenza vuota, viene restituita la stringa di lunghezza zero.
Se $arg è un nodo, la funzione restituisce il valore stringa del nodo ottenuto usando la funzione di accesso string-value. definita nella specifica W3C "XQuery 1.0 and XPath 2.0 Data Model".
Se $arg è un valore atomico, la funzione restituisce la stessa stringa restituita dal cast dell'espressione come xs:string, $arg, tranne quando diversamente specificato.
Se il tipo di $arg è xs:anyURI, l'URI viene convertito in una stringa senza eseguire l'escape di caratteri speciali.
In questa implementazione, fn:string() senza un argomento può essere usato solo nel contesto di un predicato dipendente dal contesto. In particolare, può essere utilizzata solo tra parentesi ([ ]).

Esempi

In questo argomento vengono forniti esempi di XQuery su istanze XML archiviate in varie colonne di tipo xml nel database AdventureWorks.

R. Utilizzo della funzione string

La query seguente recupera il <Features> nodo elemento figlio dell'elemento <ProductDescription> .

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

Risultato parziale:

<PD:Features xmlns:PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">  
   These are the product highlights.   
   <p1:Warranty xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">  
    <p1:WarrantyPeriod>3 years</p1:WarrantyPeriod>  
    <p1:Description>parts and labor</p1:Description>  
   </p1:Warranty>  
       ...  
</PD:Features>

Se si specifica la funzione string(), si riceve il valore stringa del nodo specificato.

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

Di seguito è riportato il risultato parziale.

These are the product highlights.   
3 yearsparts and labor...

B. Utilizzo della funzione string su vari nodi

Nell'esempio seguente, un'istanza XML viene assegnata a una variabile di tipo XML. Le query vengono specificate per illustrare il risultato dell'applicazione di string() a vari nodi.

declare @x xml  
set @x = '<?xml version="1.0" encoding="UTF-8" ?>  
<!--  This is a comment -->  
<root>  
  <a>10</a>  
just text  
  <b attr="x">20</b>  
</root>  
'

La query seguente recupera il valore stringa del nodo del documento. Il valore è formato dalla concatenazione del valore stringa di tutti i relativi nodi di testo discendenti.

select @x.query('string(/)')

Risultato:

This is a comment 10  
just text  
 20

La query seguente tenta il recupero del valore stringa del nodo di un'istruzione di elaborazione. Il risultato è una sequenza vuota, poiché non contiene un nodo di testo.

select @x.query('string(/processing-instruction()[1])')

La query seguente recupera il valore stringa del nodo di commento e restituisce il nodo di testo.

select @x.query('string(/comment()[1])')