Gestione degli spazi dei nomi in XQuery
In questo argomento vengono forniti esempi della gestione dello spazio dei nomi nelle query.
Esempi
A. Dichiarazione di uno spazio dei nomi
La query seguente recupera le fasi di produzione di un modello di prodotto specifico.
SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
/AWMI:root/AWMI:Location[1]/AWMI:step
') as x
FROM Production.ProductModel
WHERE ProductModelID=7
Risultato parziale:
<AWMI:step xmlns:AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions">Insert <AWMI:material>aluminum sheet MS-2341</AWMI:material> into the <AWMI:tool>T-85A framing tool</AWMI:tool>. </AWMI:step>
…
Si noti che la parola chiave namespace viene utilizzata per definire un nuovo prefisso dello spazio dei nomi, "AWMI:". Questo prefisso dovrà pertanto essere utilizzato nella query per tutti gli elementi che rientrano nell'ambito dello spazio dei nomi specifico.
B. Dichiarazione di uno spazio dei nomi predefinito
Nella query precedente è stato definito un nuovo prefisso dello spazio dei nomi. È stato quindi necessario utilizzare tale prefisso nella query per selezionare le strutture XML desiderate. In alternativa, è possibile dichiarare uno spazio dei nomi predefinito, come illustrato nella query modificata seguente:
SELECT Instructions.query('
declare default element namespace "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
/root/Location[1]/step
') as x
FROM Production.ProductModel
where ProductModelID=7
Risultato:
<step xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions">Insert <material>aluminum sheet MS-2341</material> into the <tool>T-85A framing tool</tool>. </step>
…
Si noti che lo spazio dei nomi definito, "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions", ignora lo spazio dei nomi predefinito o vuoto. Per questo motivo, non è più disponibile un prefisso dello spazio dei nomi nell'espressione di percorso utilizzata per la query. Non è inoltre più disponibile un prefisso dello spazio dei nomi nei nomi degli elementi visualizzati nei risultati. Inoltre, lo spazio dei nomi predefinito viene applicato a tutti gli elementi, ma non ai relativi attributi.
C. Utilizzo degli spazi dei nomi nella costruzione di codice XML
Quando si definiscono nuovi spazi dei nomi, tali spazi vengono inseriti non solo nell'ambito della query ma anche nell'ambito della costruzione. Ad esempio, per costruire codice XML è possibile definire un nuovo spazio dei nomi utilizzando la dichiarazione "declare namespace ..." e quindi utilizzare tale spazio dei nomi con gli elementi e gli attributi che verranno visualizzati nei risultati della query.
SELECT CatalogDescription.query('
declare default element namespace "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace myNS="uri:SomeNamespace";<myNS:Result>
{ /ProductDescription/Summary }
</myNS:Result>
') as Result
FROM Production.ProductModel
where ProductModelID=19
Risultato:
<myNS:Result xmlns:myNS="uri:SomeNamespace">
<Summary xmlns="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">
<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">
Our top-of-the-line competition mountain bike. Performance-enhancing
options include the innovative HL Frame, super-smooth front
suspension, and traction for all terrain.</p1:p>
</Summary>
</myNS:Result>
In alternativa, è inoltre possibile definire lo spazio dei nomi in modo esplicito in ogni punto in cui viene utilizzato come parte della costruzione XML, come illustrato nella query seguente:
SELECT CatalogDescription.query('
declare default element namespace "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
<myNS:Result xmlns:myNS="uri:SomeNamespace">
{ /ProductDescription/Summary }
</myNS:Result>
') as Result
FROM Production.ProductModel
where ProductModelID=19
D. Costruzione tramite gli spazi dei nomi predefiniti
È inoltre possibile definire uno spazio dei nomi predefinito da utilizzare nel codice XML costruito. Ad esempio, la query seguente specifica uno spazio dei nomi predefinito, "uri:SomeNamespace"\, che verrà utilizzato per gli elementi denominati a livello locale costruiti, ad esempio l'elemento <Result>.
SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare default element namespace "uri:SomeNamespace";<Result>
{ /PD:ProductDescription/PD:Summary }
</Result>
') as Result
FROM Production.ProductModel
where ProductModelID=19
Risultato:
<Result xmlns="uri:SomeNamespace">
<PD:Summary xmlns:PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">
<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">
Our top-of-the-line competition mountain bike. Performance-
enhancing options include the innovative HL Frame, super-smooth
front suspension, and traction for all terrain.</p1:p>
</PD:Summary>
</Result>
Si noti che, dato che lo spazio dei nomi predefinito o lo spazio dei nomi vuoto vengono ignorati, tutti gli elementi denominati a livello locale nel codice XML costruito vengono associati allo spazio dei nomi predefinito sostitutivo. Se la costruzione del codice XML richiede flessibilità per poter sfruttare lo spazio dei nomi vuoto, è pertanto consigliabile non ignorare lo spazio dei nomi predefinito.
Vedere anche