Gestion des espaces de noms dans XQuery
Cette rubrique fournit des exemples qui illustrent comment gérer les espaces de noms dans les requêtes.
Exemples
A. Déclaration d'un espace de noms
La requête suivante récupère les étapes de fabrication d'un modèle de produit spécifique.
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
Voici le résultat partiel :
<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>
…
Notez que le mot clé namespace sert à définir un nouveau préfixe d'espace de noms, « AWMI: ». Ce préfixe doit ensuite être utilisé dans la requête pour tous les éléments couverts par l'étendue de cet espace de noms.
B. Déclaration d'un espace de noms par défaut
Dans la requête précédente, un nouveau préfixe d'espace de noms a été défini. Il a fallu ensuite utiliser ce préfixe dans la requête pour sélectionner les structures XML appropriées. Une alternative consiste à déclarer un espace de noms par défaut, comme le montre la requête modifiée suivante :
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
Voici le résultat :
<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>
…
Notez, dans cet exemple, que l'espace de noms défini, "https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions", est créé pour remplacer l'espace de noms par défaut ou vide. Grâce à cela, vous pouvez vous passer d'un préfixe d'espace de noms dans l'expression de chemin utilisée lors de l'interrogation. Le préfixe d'espace de noms devient également inutile dans les noms d'élément qui apparaissent dans les résultats. De plus, l'espace de noms par défaut s'applique à tous les éléments, mais pas à leurs attributs.
C. Utilisation des espaces de noms dans la construction XML
Lorsque vous définissez de nouveaux espaces de noms, ils ont un rôle à jouer non seulement dans la requête, mais aussi dans la construction. Lors de la construction XML par exemple, vous pouvez définir un nouvel espace de noms à l'aide de la déclaration « declare namespace ... », puis l'utiliser avec les éléments et les attributs que vous souhaitez faire apparaître dans les résultats de la requête.
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
Voici le résultat obtenu :
<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>
Vous pouvez également définir l'espace de noms explicitement à chaque stade où il intervient dans la construction XML, comme le montre la requête suivante :
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. Construction à l'aide des espaces de noms par défaut
Vous pouvez aussi définir un espace de noms par défaut en vue de son utilisation dans le code XML construit. Par exemple, la requête suivante montre comment spécifier un espace de noms par défaut, "uri:SomeNamespace"\, pour l'utiliser comme valeur par défaut dans les éléments nommés localement dans le code XML construit, comme l'élément <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
Voici le résultat obtenu :
<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>
Notez qu'en remplaçant l'espace de noms d'élément par défaut ou l'espace de noms vide, tous les éléments nommés localement dans le code XML construit sont par la suite liés à l'espace de noms par défaut de substitution. Par conséquent, si vous voulez profiter de la souplesse d'un espace de noms vide lors de la construction XML, évitez de remplacer l'espace de noms d'élément par défaut.
Voir aussi
Concepts
Ajout d'espaces de noms à l'aide de WITH XMLNAMESPACES
Type de données xml
Autres ressources
Requêtes XQuery impliquant le type de données xml