Séquence et QNames (XQuery)

Séquence

Dans XQuery, le résultat d'une expression est une séquence composée d'une liste de nœuds XML et d'instances de types atomiques XSD. Une entrée d'une séquence porte le nom d'élément. Un élément d'une séquence peut être :

• un nœud, tel qu'un élément, attribut, texte, instruction de traitement, commentaire ou document ;

• une valeur atomique, telle qu'une instance d'un type simple XSD.

Par exemple, la requête suivante construit une séquence de deux éléments de nœud d'élément :

SELECT Instructions.query('
     <step1> Step 1 description goes here</step1>,
     <step2> Step 2 description goes here </step2>
') AS Result
FROM Production.ProductModel
WHERE ProductModelID=7

Voici le résultat obtenu :

<step1> Step 1 description goes here </step1>
<step2> Step 2 description goes here </step2> 

Dans la requête précédente, la virgule (,) à la fin de la construction <step1> est le constructeur de séquence ; elle est obligatoire. Les espaces dans les résultats sont ajoutés uniquement à titre d'illustration et sont inclus dans tous les résultats d'exemple de cette documentation.

Voici quelques informations supplémentaires utiles concernant les séquences :

• Si une requête génère une séquence qui contient une autre séquence, la séquence contenue est aplatie dans la séquence conteneuse. Par exemple, la séquence ((1,2, (3,4,5)),6) est aplatie dans le modèle de données sous la forme (1, 2, 3, 4, 5, 6).

  DECLARE @x xml
  SET @x = ''
  SELECT @x.query('(1,2, (3,4,5)),6')
  

• Une séquence vide est une séquence qui ne contient aucun élément. Elle est représentée sous la forme « () ».

• Une séquence contenant un seul élément peut être traitée comme une valeur atomique, et inversement. À savoir, (1) = 1.

Dans cette implémentation, la séquence doit être homogène. Autrement dit, vous devez avoir soit une séquence de valeurs atomiques, soit une séquence de nœuds. Par exemple, les séquences suivantes sont valides :

DECLARE @x xml
SET @x = ''
-- Expression returns a sequence of 1 text node (singleton).
SELECT @x.query('1')
-- Expression returns a sequence of 2 text nodes
SELECT @x.query('"abc", "xyz"')
-- Expression returns a sequence of one atomic value. data() returns
-- typed value of the node.
SELECT @x.query('data(1)')
-- Expression returns a sequence of one element node. 
-- In the expression XML construction is used to construct an element.
SELECT @x.query('<x> {1+2} </x>')

La requête suivante retourne une erreur car les séquences hétérogènes ne sont pas prises en charge.

SELECT @x.query('<x>11</x>, 22')

QName

Chaque identificateur d'une XQuery est un QName. Un QName est constitué d'un préfixe d'espace de noms et d'un nom local. Dans cette implémentation, les noms de variables dans XQuery sont des QNames et ne peuvent pas avoir de préfixes.

Prenons l'exemple suivant, dans lequel une requête est spécifiée sur une variable xml non typée :

DECLARE @x xml
SET @x = '<Root><a>111</a></Root>'
SELECT @x.query('/Root/a')

Dans l'expression (/Root/a), Root et a sont des QNames.

Dans l'exemple suivant, une requête est spécifiée sur une colonne xml typée. La requête itère sur tous les éléments <step> au premier atelier.

SELECT Instructions.query('
   declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
for $Step in /AWMI:root/AWMI:Location[1]/AWMI:step
      return
           string($Step) 
') AS Result
FROM Production.ProductModel
WHERE ProductModelID=7

Dans l'expression de requête, notez ce qui suit :

• AWMI root, AWMI:Location, AWMI:step et $Step sont tous des QNames. AWMI est un préfixe et root, Location et Step sont tous des noms locaux.

• La variable $step est un QName ; elle n'a pas de préfixe.

Les espaces de noms suivants sont prédéfinis pour une utilisation avec prise en charge de XQuery dans SQL Server.

Chaque base de données que vous créez a la collection de schémas XML sys. Elle réserve ces schémas de sorte qu'ils soient accessibles à partir de toute collection de schémas XML créée par l'utilisateur. Pour plus d'informations, consultez Collection de schémas XML intégrés (sys).

Voir aussi

Concepts

Autres ressources