Expressions de séquence (XQuery)
S’applique à :
SQL Server
SQL Server prend en charge les opérateurs XQuery utilisés pour construire, filtrer et combiner une séquence d’éléments. Un élément peut être une valeur atomique ou un nœud.
Construction des séquences
Vous pouvez utiliser l'opérateur comma (virgule) pour construire une séquence qui concatène les éléments en une seule séquence.
Une séquence peut contenir des doublons. Les séquences imbriquées (une séquence dans une autre séquence) sont réduites. Par exemple, la séquence (1, 2, (3, 4, (5))) devient (1, 2, 3, 4, 5). Voici des exemples de construction de séquences.
Exemple A
La requête suivante renvoie une séquence de cinq valeurs atomiques :
declare @x xml
set @x=''
select @x.query('(1,2,3,4,5)')
go
-- result 1 2 3 4 5
La requête suivante renvoie une séquence de deux nœuds :
-- sequence of 2 nodes
declare @x xml
set @x=''
select @x.query('(<a/>, <b/>)')
go
-- result
<a />
<b />
La requête suivante renvoie une erreur car vous construisez une séquence de valeurs atomiques et de nœuds. Il s'agit alors d'une séquence hétérogène qui n'est pas prise en charge.
declare @x xml
set @x=''
select @x.query('(1, 2, <a/>, <b/>)')
go
Exemple B
La requête suivante construit une séquence de valeurs atomiques en combinant quatre séquences de longueur différente en une seule.
declare @x xml
set @x=''
select @x.query('(1,2),10,(),(4, 5, 6)')
go
-- result = 1 2 10 4 5 6
Vous pouvez trier la séquence à l'aide de FLOWR et de ORDER BY :
declare @x xml
set @x=''
select @x.query('for $i in ((1,2),10,(),(4, 5, 6))
order by $i
return $i')
go
Vous pouvez compter les éléments de la séquence à l’aide de la fonction fn:count().
declare @x xml
set @x=''
select @x.query('count( (1,2,3,(),4) )')
go
-- result = 4
Exemple C
La requête suivante est spécifiée par rapport à la colonne AdditionalContactInfo du type xml dans la table Contact. Cette colonne stocke les informations supplémentaires des contacts tels qu'un ou plusieurs numéros de téléphone, numéros de pager et adresses supplémentaires. Le <numéro de> téléphone, <le pagineur> et d’autres nœuds peuvent apparaître n’importe où dans le document. La requête construit une séquence qui contient tous les <enfants telephoneNumber> du nœud de contexte, suivis des enfants du <pagineur> . Notez l'utilisation de l'opérateur de séquence comma (virgule) dans l'expression de renvoi, ($a//act:telephoneNumber, $a//act:pager).
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes' AS act,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo' AS aci)
SELECT AdditionalContactInfo.query('
for $a in /aci:AdditionalContactInfo
return ($a//act:telephoneNumber, $a//act:pager)
') As Result
FROM Person.Contact
WHERE ContactID=3
Voici le résultat obtenu :
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
<act:number>333-333-3333</act:number>
</act:telephoneNumber>
<act:telephoneNumber xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
<act:number>333-333-3334</act:number>
</act:telephoneNumber>
<act:pager xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">
<act:number>999-555-1244</act:number>
<act:SpecialInstructions>
Page only in case of emergencies.
</act:SpecialInstructions>
</act:pager>
Filtrage des séquences
Vous pouvez filtrer la séquence renvoyée par une expression en ajoutant un prédicat à l'expression. Pour plus d’informations, consultez Path Expressions (XQuery). Par exemple, la requête suivante retourne une séquence de nœuds de trois <a> éléments :
declare @x xml
set @x = '<root>
<a attrA="1">111</a>
<a></a>
<a></a>
</root>'
SELECT @x.query('/root/a')
Voici le résultat obtenu :
<a attrA="1">111</a>
<a />
<a />
Pour récupérer uniquement <a> les éléments qui ont l’attribut attrA, vous pouvez spécifier un filtre dans le prédicat. La séquence résultante n’aura qu’un <a> seul élément.
declare @x xml
set @x = '<root>
<a attrA="1">111</a>
<a></a>
<a></a>
</root>'
SELECT @x.query('/root/a[@attrA]')
Voici le résultat obtenu :
<a attrA="1">111</a>
Pour plus d’informations sur la façon de spécifier des prédicats dans une expression de chemin d’accès, consultez Spécification de prédicats dans une étape d’expression de chemin d’accès.
L'exemple suivant construit une expression de séquence de sous-arborescences, puis applique un filtre à la séquence.
declare @x xml
set @x = '
<a>
<c>C under a</c>
</a>
<b>
<c>C under b</c>
</b>
<c>top level c</c>
<d></d>
'
L'expression de (/a, /b) construit une séquence composée des sous-arborescences /a et /b, et filtre l'élément <c> à partir de la séquence résultante.
SELECT @x.query('
(/a, /b)/c
')
Voici le résultat obtenu :
<c>C under a</c>
<c>C under b</c>
L'exemple suivant applique un filtre de prédicat. L’expression recherche des éléments <a> et>b< qui contiennent l’élément .<c>
declare @x xml
set @x = '
<a>
<c>C under a</c>
</a>
<b>
<c>C under b</c>
</b>
<c>top level c</c>
<d></d>
'
SELECT @x.query('
(/a, /b)[c]
')
Voici le résultat obtenu :
<a>
<c>C under a</c>
</a>
<b>
<c>C under b</c>
</b>
Limites de mise en œuvre
Les limitations suivantes s'appliquent :
L'expression de plage XQuery n'est pas prise en charge.
Les séquences doivent être homogènes. Plus précisément, tous les éléments d'une séquence doivent être soit des nœuds, soit des valeurs atomiques. Le contrôle s'effectue de façon statique.
La combinaison de séquences de nœuds à l'aide des opérateurs UNION, INTERSECT ou EXCEPT n'est pas prise en charge.