Expressions primaires (XQuery)
S'applique à : 
SQL Server
Les expressions primaires XQuery incluent : littéraux, références à une variable, expressions d'élément contextuel, constructeurs et appels de fonction.
Littéraux
Les littéraux XQuery peuvent être des littéraux numériques ou des chaînes de caractères. Un littéral chaîne peut inclure des références d'entité prédéfinies. Une référence d'entité est une séquence de caractères qui commence par un « et commercial » et qui représente un seul et unique caractère qui aurait autrement une signification syntaxique particulière. Voici quelques exemples de références d'entité prédéfinies pour XQuery.
| Référence d’entité | Représente |
|---|---|
< |
< |
> |
> |
& |
& |
" |
" |
' |
' |
Un littéral chaîne peut également comprendre une référence de caractère (référence de style XML à un caractère Unicode) qui est identifiée par un point de code décimal ou hexadécimal. Par exemple, le symbole Euro peut être représenté par la référence de caractère « € ; ».
Remarque
SQL Server utilise XML version 1.0 comme base pour l’analyse.
Exemples
Les exemples suivants expliquent comment utiliser des littéraux, ainsi que des références d'entité et de caractère.
Ce code retourne une erreur, car les caractères <' et '> ont une signification particulière.
DECLARE @var XML
SET @var = ''
SELECT @var.query(' <SalaryRange>Salary > 50000 and < 100000</SalaryRange>')
GO
Si vous utilisez une référence d'entité à la place, la requête aboutit.
DECLARE @var XML
SET @var = ''
SELECT @var.query(' <SalaryRange>Salary > 50000 and < 100000</SalaryRange>')
GO
L'exemple suivant montre comment utiliser une référence de caractère pour représenter le symbole Euro.
DECLARE @var XML
SET @var = ''
SELECT @var.query(' <a>€12.50</a>')
Voici l'ensemble de résultats.
<a>€12.50</a>
Dans l'exemple suivant, la requête est délimitée par des apostrophes. Par conséquent, l'apostrophe de la valeur de chaîne doit donc être doublée.
DECLARE @var XML
SET @var = ''
SELECT @var.query('<a>I don''t know</a>')
Go
Voici l'ensemble de résultats.
<a>I don't know</a>
Les fonctions booléennes intégrées, true() et false(), peuvent être utilisées pour représenter des valeurs booléennes, comme illustré dans l’exemple suivant.
DECLARE @var XML
SET @var = ''
SELECT @var.query('<a>{true()}</a>')
GO
Le constructeur direct d'élément spécifie une expression entre accolades, qui est remplacée par sa valeur dans le code XML qui en résulte.
Voici l'ensemble de résultats.
<a>true</a>
Références à une variable
Dans XQuery, les références à une variable se présentent sous la forme d'un QName précédé d'un signe $. Cette mise en œuvre ne prend en charge que les références faites à des variables non préfixées. Par exemple, la requête suivante définit la variable $i dans l'expression FLWOR.
DECLARE @var XML
SET @var = '<root>1</root>'
SELECT @var.query('
for $i in /root return data($i)')
GO
La requête suivante ne fonctionnera pas car un préfixe d'espace de noms est ajouté au nom de la variable.
DECLARE @var XML
SET @var = '<root>1</root>'
SELECT @var.query('
DECLARE namespace x="https://X";
for $x:i in /root return data($x:i)')
GO
Vous pouvez utiliser la fonction d’extension sql :variable() pour faire référence à des variables SQL, comme illustré dans la requête suivante.
DECLARE @price money
SET @price=2500
DECLARE @x xml
SET @x = ''
SELECT @x.query('<value>{sql:variable("@price") }</value>')
Voici l'ensemble de résultats.
<value>2500</value>
Limites de mise en œuvre
Les limites de la mise en œuvre sont les suivantes :
Les variables dotées d'un préfixe d'espace de noms ne sont pas prises en charge.
L'importation de modules n'est pas prise en charge.
Les déclarations de variable externe ne sont pas prises en charge. Une solution à ceci consiste à utiliser la fonction sql :variable().
Expressions d'élément contextuel
L'élément contextuel est l'élément en cours de traitement dans le cadre d'une expression de chemin d'accès. Il est initialisé dans une instance non-NULL de type XML avec le nœud de document. Elle peut également être modifiée par la méthode node(), dans le contexte des expressions XPath ou des prédicats [].
L'élément contextuel est renvoyé par une expression contenant un point (.). Par exemple, la requête suivante évalue chaque élément <a> pour la présence de l’attribut.attr Si l'attribut est présent, l'élément est renvoyé. Notez que la condition exprimée dans le prédicat indique que le nœud de contexte est spécifié par un simple point.
DECLARE @var XML
SET @var = '<ROOT>
<a>1</a>
<a attr="1">2</a>
</ROOT>'
SELECT @var.query('/ROOT[1]/a[./@attr]')
Voici l'ensemble de résultats.
<a attr="1">2</a>
Appels de fonction
Vous pouvez appeler des fonctions XQuery intégrées et les fonctions SQL Server sql :variable() et sql :column(). Pour obtenir la liste des fonctions implémentées, consultez les fonctions XQuery par rapport au type de données xml.
Limites de mise en œuvre
Les limites de la mise en œuvre sont les suivantes :
Il est impossible de déclarer une fonction dans le prologue XQuery.
L'importation de fonctions n'est pas prise en charge.