Aggiungere spazi dei nomi alle query con WITH XMLNAMESPACES

La clausola WITH XMLNAMESPACES (Transact-SQL) offre il supporto dell'URI dello spazio dei nomi nel modo seguente:

Rende disponibile il mapping tra il prefisso dello spazio dei nomi e l'URI quando si eseguono query per la costruzione di XML utilizzando FOR XML.
Rende disponibile l'associazione tra namespace e URI nel contesto del namespace statico dei metodi del tipo di dati XML.

Utilizzo di WITH XMLNAMESPACES nelle query FOR XML

WITH XMLNAMESPACES consente di includere gli spazi dei nomi XML nelle query FOR XML. Si consideri, ad esempio, la query FOR XML seguente:

SELECT ProductID, Name, Color  
FROM   Production.Product  
WHERE  ProductID=316 or ProductID=317  
FOR XML RAW

Risultato:

<row ProductID="316" Name="Blade" />  
<row ProductID="317" Name="LL Crankarm" Color="Black" />

Per aggiungere namespace al codice XML creato dalla query FOR XML, innanzitutto specificare il mapping tra il prefisso del namespace e l'URI utilizzando la clausola WITH NAMESPACES. Utilizzare quindi i prefissi dello spazio dei nomi per specificare i nomi nella query, come illustrato nella query modificata seguente. Si noti che la clausola WITH XMLNAMESPACES specifica la mappatura del prefisso dello spazio dei nomi (ns1) all'URI (uri). Il prefisso ns1 viene quindi utilizzato per specificare i nomi degli elementi e degli attributi che devono essere creati per la query FOR XML.

WITH XMLNAMESPACES ('uri' as ns1)  
SELECT ProductID as 'ns1:ProductID',  
       Name      as 'ns1:Name',   
       Color     as 'ns1:Color'  
FROM Production.Product  
WHERE ProductID=316 or ProductID=317  
FOR XML RAW ('ns1:Prod'), ELEMENTS

Il risultato XML include i prefissi dello spazio dei nomi:

<ns1:Prod xmlns:ns1="uri">  
  <ns1:ProductID>316</ns1:ProductID>  
  <ns1:Name>Blade</ns1:Name>  
</ns1:Prod>  
<ns1:Prod xmlns:ns1="uri">  
  <ns1:ProductID>317</ns1:ProductID>  
  <ns1:Name>LL Crankarm</ns1:Name>  
  <ns1:Color>Black</ns1:Color>  
</ns1:Prod>

Per la clausola WITH XMLNAMESPACES sono valide le osservazioni seguenti:

La clausola è supportata solo nelle modalità RAW, AUTO e PATH delle query FOR XML. La modalità EXPLICIT non è supportata.
La clausola influisce solo sui prefissi dello spazio dei nomi delle query FOR XML e sui metodi con tipo di dati xml , ma non sul parser XML. Ad esempio, la query seguente restituisce un errore perché nel documento XML non è disponibile una dichiarazione dello spazio dei nomi per il prefisso myNS.
Le direttive FOR XML, XMLSCHEMA e XMLDATA non possono essere utilizzate quando viene utilizzata una clausola WITH XMLNAMESPACES.
```
CREATE TABLE T (x xml)  
go  
WITH XMLNAMESPACES ('http://abc' as myNS )  
INSERT INTO T VALUES('<myNS:root/>')  
```

Utilizzo della direttiva XSINIL

Non è possibile definire il prefisso xsi nella clausola WITH XMLNAMESPACES se si utilizza la direttiva ELEMENTS XSINIL. Viene invece aggiunto automaticamente quando si utilizza ELEMENTS XSINIL. La query seguente usa ELEMENTS XSINIL che genera codice XML incentrato sugli elementi nel quale viene eseguito il mapping dei valori Null a elementi con l'attributo xsi:nil impostato su True.

WITH XMLNAMESPACES ('uri' as ns1)  
SELECT ProductID as 'ns1:ProductID',  
       Name      as 'ns1:Name',   
       Color     as 'ns1:Color'  
FROM Production.Product  
WHERE ProductID=316   
FOR XML RAW, ELEMENTS XSINIL

Risultato:

<row xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns1="uri">  
  <ns1:ProductID>316</ns1:ProductID>  
  <ns1:Name>Blade</ns1:Name>  
  <ns1:Color xsi:nil="true" />  
</row>

Specificare i namespace predefiniti

Anziché dichiarare un prefisso dello spazio dei nomi, è possibile dichiarare uno spazio dei nomi predefinito utilizzando la parola chiave DEFAULT. Nella query FOR XML, verrà associato il namespace predefinito ai nodi XML nel XML risultante. Nell'esempio seguente, la clausola WITH XMLNAMESPACES definisce due prefissi di spazio dei nomi che vengono definiti insieme a uno spazio dei nomi predefinito.

WITH XMLNAMESPACES ('uri1' as ns1,   
                    'uri2' as ns2,  
                    DEFAULT 'uri2')  
SELECT ProductID,   
      Name,  
      Color  
FROM Production.Product   
WHERE ProductID=316 or ProductID=317  
FOR XML RAW ('ns1:Product'), ROOT('ns2:root'), ELEMENTS

La query FOR XML genera codice XML incentrato sugli elementi. Si noti che la query utilizza entrambi i prefissi dello spazio dei nomi nella denominazione dei nodi. Nella clausola SELECT, ProductID, Name e Color non specificano un nome con alcun prefisso. e pertanto gli elementi corrispondenti nel codice XML risultante appartengono allo spazio dei nomi predefinito.

<ns2:root xmlns="uri2" xmlns:ns2="uri2" xmlns:ns1="uri1">  
  <ns1:Product>  
    <ProductID>316</ProductID>  
    <Name>Blade</Name>  
  </ns1:Product>  
  <ns1:Product>  
    <ProductID>317</ProductID>  
    <Name>LL Crankarm</Name>  
    <Color>Black</Color>  
  </ns1:Product>  
</ns2:root>

La query seguente è simile alla precedente, eccetto che per il fatto che è specificata la modalità FOR XML AUTO.

WITH XMLNAMESPACES ('uri1' as ns1,  'uri2' as ns2,DEFAULT 'uri2')  
SELECT ProductID,   
      Name,  
      Color  
FROM Production.Product as "ns1:Product"  
WHERE ProductID=316 or ProductID=317  
FOR XML AUTO, ROOT('ns2:root'), ELEMENTS

Uso dei namespace predefiniti

Quando si utilizzano gli spazi dei nomi predefiniti, tranne lo spazio dei nomi xml e lo spazio dei nomi xsi quando si utilizza ELEMENTS XSINIL, è necessario specificare in modo esplicito l'associazione degli spazi dei nomi utilizzando WITH XMLNAMESPACES. La query seguente definisce esplicitamente l'associazione tra il prefisso dello spazio dei nomi e l'URI per il namespace predefinito (urn:schemas-microsoft-com:xml-sql).

WITH XMLNAMESPACES ('urn:schemas-microsoft-com:xml-sql' as sql)  
SELECT 'SELECT * FROM Customers FOR XML AUTO, ROOT("a")' AS "sql:query"  
FOR XML PATH('sql:root')

Di seguito è riportato il risultato. Gli utenti di SQLXML hanno familiarità con questo modello XML. Per altre informazioni, vedere Concetti relativi alla programmazione SQLXML 4.0.

<sql:root xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
  <sql:query>SELECT * FROM Customers FOR XML AUTO, ROOT("a")</sql:query>  
</sql:root>

Il prefisso dello spazio dei nomi xml è l'unico che può essere utilizzato senza che sia necessario definirlo in modo esplicito in WITH XMLNAMESPACES, come illustrato nella query seguente in modalità PATH. Se si dichiara questo prefisso, è anche necessario associarlo allo spazio dei nomi http://www.w3.org/XML/1998/namespace. I nomi specificati nella clausola SELECT fanno riferimento al prefisso dello spazio dei nomi xml non definito in modo esplicito tramite WITH XMLNAMESPACES.

SELECT 'en'    as "English/@xml:lang",  
       'food'  as "English",  
       'ger'   as "German/@xml:lang",  
       'Essen' as "German"  
FOR XML PATH ('Translation')  
go

Gli attributi @xml:lang usano lo spazio dei nomi xml predefinito. Poiché la versione XML 1.0 non richiede la dichiarazione esplicita dell'associazione dello spazio dei nomi xml, il risultato non includerà una dichiarazione esplicita dell'associazione dello spazio dei nomi.

Risultato:

<Translation>  
  <English xml:lang="en">food</English>  
  <German xml:lang="ger">Essen</German>  
</Translation>

Utilizzo di WITH XMLNAMESPACES con i metodi del tipo di dati xml

I metodi del tipo di dati xml specificati in una query SELECT, o in UPDATE quando si tratta del metodo modify(), devono tutti ripetere la dichiarazione dello spazio dei nomi nel loro prologo. e possono richiedere pertanto molto tempo. Ad esempio, la query seguente recupera gli ID dei modelli di prodotto per i quali esistono specifiche nelle descrizioni del catalogo, Ovvero, l'elemento <Specifications> esiste.

SELECT ProductModelID, CatalogDescription.query('  
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
    <Product   
        ProductModelID= "{ sql:column("ProductModelID") }"   
        />  
') AS Result  
FROM Production.ProductModel  
WHERE CatalogDescription.exist('  
    declare namespace  pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
     /pd:ProductDescription[(pd:Specifications)]'  
    ) = 1

Nella query precedente, sia il metodo query() che exist() dichiarano lo stesso namespace nel prologo. Per esempio:

declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";

In alternativa, è possibile dichiarare innanzitutto WITH XMLNAMESPACES e utilizzare i prefissi dello spazio dei nomi nella query. In questo caso, i metodi query() e exist() non devono includere le dichiarazioni dello spazio dei nomi nel prologo.

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' as pd)  
SELECT ProductModelID, CatalogDescription.query('  
    <Product   
        ProductModelID= "{ sql:column("ProductModelID") }"   
        />  
') AS Result  
FROM Production.ProductModel  
WHERE CatalogDescription.exist('  
     /pd:ProductDescription[(pd:Specifications)]'  
    ) = 1  
Go

Si noti che una dichiarazione esplicita nel prologo XQuery esegue l'override del prefisso dello spazio dei nomi e dello spazio dei nomi predefinito degli elementi definiti nella clausola WITH.

Vedere anche

Metodi del Tipo di Dati XML
Riferimento al linguaggio XQuery (SQL Server)
WITH XMLNAMESPACES (Transact-SQL)
FOR XML (SQL Server)

Last updated on 2017-06-13

Condividi tramite

Aggiungere spazi dei nomi alle query con WITH XMLNAMESPACES

Utilizzo di WITH XMLNAMESPACES nelle query FOR XML

Utilizzo della direttiva XSINIL

Specificare i namespace predefiniti

Uso dei namespace predefiniti

Utilizzo di WITH XMLNAMESPACES con i metodi del tipo di dati xml

Vedere anche

Risorse aggiuntive