Spécification de prédicats dans une étape d'expression de chemin d'accès

Les quantificateurs peuvent être utilisés et ajoutés plusieurs fois au sein des accolades du prédicat lui-même. Par exemple, en utilisant l'exemple précédent, ce qui suit est une utilisation valide de plusieurs quantificateurs au sein d'une sous-expression de prédicat complexe.

select @x.query('/People/Person[contains(Name[1], "J") and xs:integer(Age[1]) < 40]/Name/text()')

Le résultat d'une expression de prédicat est converti en valeur booléenne et est appelé valeur de vérité du prédicat. Seuls les nœuds de la séquence pour lesquels la valeur de vérité du prédicat est True sont retournés dans le résultat. Tous les autres nœuds sont ignorés.

Par exemple, l'expression de chemin d'accès ci-dessous inclut un prédicat dans sa deuxième étape :

/child::root/child::Location[attribute::LocationID=10]

La condition spécifiée par ce prédicat est appliquée à tous les nœuds d'élément <Location> enfants. Il en résulte que seuls les ateliers dont l'attribut LocationID a la valeur 10 sont retournés.

L'expression de chemin d'accès précédente est exécutée dans l'instruction SELECT suivante :

SELECT Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
 /child::AWMI:root/child::AWMI:Location[attribute::LocationID=10]
')
FROM Production.ProductModel
WHERE ProductModelID=7

Les règles ci-dessous s'appliquent pour déterminer la valeur de vérité de prédicat, en fonction des spécifications XQuery :

1. Si la valeur de l'expression de prédicat est une séquence vide, la valeur de vérité de prédicat est False.

   Par exemple :

   SELECT Instructions.query('
   declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
    /child::AWMI:root/child::AWMI:Location[attribute::LotSize]
   ')
   FROM Production.ProductModel
   WHERE ProductModelID=7
   

   L'expression de chemin d'accès dans cette requête retourne uniquement les nœuds d'élément <Location> pour lesquels un attribut LotSize est spécifié. Si le prédicat retourne une séquence vide pour un <Location> spécifique, cet atelier n'est pas retourné dans le résultat.

2. Les valeurs de prédicat peuvent uniquement être xs:integer, xs:Boolean ou node*. Pour node*, le prédicat a la valeur True si des nœuds existent et la valeur False dans le cas d'une séquence vide. Tout autre type numérique, tel que le type double et float, génère une erreur de type statique. La valeur de vérité de prédicat d'une expression est True si et seulement si l'entier résultant est égal à la valeur de la position du contexte. En outre, seules des valeurs littérales entières et la fonction last() réduisent la cardinalité de l'expression d'étape filtrée à 1.

   Par exemple, la requête ci-dessous récupère le troisième nœud d'élément enfant de l'élément <Features>.

   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::*[3]
   ')
   FROM Production.ProductModel
   WHERE ProductModelID=19
   

   Notez ce qui suit à partir de la requête précédente :

   • La troisième étape de l'expression spécifie une expression de prédicat dont la valeur est 3. Par conséquent, la valeur de vérité du prédicat de cette expression est True uniquement pour les nœuds dont la position contextuelle est 3.

   • La troisième étape spécifie également un caractère générique (*) qui indique tous les nœuds dans le test de nœud. Toutefois, le prédicat filtre les nœuds et retourne uniquement le nœud en troisième position.

   • La requête retourne le troisième nœud d'élément enfant des éléments enfants <Features> des éléments enfants <ProductDescription> du document racine.

3. Si la valeur de l'expression de prédicat est une valeur de type simple de type booléen, la valeur de vérité de prédicat est égale à la valeur de l'expression de prédicat.

   Par exemple, la requête suivante est spécifiée sur une variable de type xmlqui détient une instance XML, l'instance XML d'une étude de clients. La requête récupère les clients qui ont des enfants. Dans cette requête, il s'agirait de <HasChildren>1</HasChildren>.

   declare @x xml
   set @x='
   <Survey>
     <Customer CustomerID="1" >
     <Age>27</Age>
     <Income>20000</Income>
     <HasChildren>1</HasChildren>
     </Customer>
     <Customer CustomerID="2" >
     <Age>27</Age>
     <Income>20000</Income>
     <HasChildren>0</HasChildren>
     </Customer>
   </Survey>
   '
   declare @y xml
   set @y = @x.query('
     for $c in /child::Survey/child::Customer[( child::HasChildren[1] cast as xs:boolean ? )]
     return 
         <CustomerWithChildren>
             { $c/attribute::CustomerID }
         </CustomerWithChildren>
   ')
   select @y
   

   Notez ce qui suit à partir de la requête précédente :

   • L'expression dans la boucle for a deux étapes et la seconde étape spécifie un prédicat. La valeur de ce prédicat est une valeur de type booléen. Si cette valeur est True, la valeur de vérité du prédicat est également True.

   • La requête retourne les éléments enfants <Customer>, dont la valeur de prédicat est True, des éléments enfants <Survey> du document racine. Voici le jeu de résultats obtenu :

     <CustomerWithChildren CustomerID="1"/> 
     

4. Si la valeur de l'expression de prédicat est une séquence contenant au moins un nœud, la valeur de vérité de prédicat est True.

Par exemple, la requête ci-dessous récupère ProductModelID pour les modèles de produit dont la description du catalogue XML inclut au moins une fonctionnalité, un élément enfant de l'élément <Features>, à partir de l'espace de noms associé au préfixe wm.

SELECT ProductModelID
FROM   Production.ProductModel
WHERE CatalogDescription.exist('
             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[wm:*]
             ') = 1

Notez ce qui suit à partir de la requête précédente :

• La clause WHERE spécifie la méthode exist() (type de données XML).

• L'expression de chemin d'accès dans la méthode exist() spécifie un prédicat de la deuxième étape. Si l'expression de prédicat retourne une séquence d'au moins une fonctionnalité, la valeur de vérité de cette expression de prédicat est True. Dans ce cas, étant donné que la méthode exist() retourne une valeur True, ProductModelID est retourné.