Expressions primaires (XQuery)

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.

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 « € ».

Exemples

DECLARE @var XML
SET @var = ''
SELECT @var.query(' <SalaryRange>Salary > 50000 and < 100000</SalaryRange>')
GO

DECLARE @var XML
SET @var = ''
SELECT @var.query(' <SalaryRange>Salary &gt; 50000 and &lt; 100000</SalaryRange>')
GO

DECLARE @var XML
SET @var = ''
SELECT @var.query(' <a>&#8364;12.50</a>')

DECLARE @var XML
SET @var = ''
SELECT @var.query('<a>I don''t know</a>')
Go

DECLARE @var XML
SET @var = ''
SELECT @var.query('<a>{true()}</a>')
GO

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="http://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 le montre 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>

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. Il peut aussi être modifié par la méthode nodes(), dans le cadre 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> de façon à déterminer 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, ainsi que les fonctions sql:variable() et sql:column() de SQL Server. Pour obtenir la liste des fonctions implémentées, consultez Fonctions XQuery impliquant le type de données xml.

Voir aussi

Concepts