Instructions pour l'utilisation des méthodes de type de données XML

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Cette rubrique décrit comment utiliser les méthodes de type de données xml.

Instruction PRINT

Les méthodes de type de données xml ne peuvent pas être utilisées dans l’instruction PRINT, comme l’illustre l’exemple ci-dessous. Les méthodes de type de données xml sont traitées comme des sous-requêtes et les sous-requêtes ne sont pas autorisées dans l’instruction PRINT. Par conséquent, l'exemple ci-dessous retourne une erreur :

DECLARE @x XML
SET @x = '<root>Hello</root>'
PRINT @x.value('/root[1]', 'varchar(20)') -- will not work because this is treated as a subquery (select top 1 col from table)

Une solution consiste à affecter le résultat de la méthode value() à une variable de type xml, puis à spécifier la variable dans la requête.

DECLARE @x XML
DECLARE @c VARCHAR(max)
SET @x = '<root>Hello</root>'
SET @c = @x.value('/root[1]', 'VARCHAR(11)')
PRINT @c

Clause GROUP BY

Les méthodes de type de données xml sont traitées en interne comme des sous-requêtes. Comme la clause GROUP BY nécessite une valeur scalaire et n’autorise pas les agrégats et les sous-requêtes, vous ne pouvez pas spécifier les méthodes de type de données xml dans la clause GROUP BY. Une solution consiste à appeler une fonction définie par l'utilisateur qui utilise des méthodes XML en son sein.

Signalement des erreurs

Lors du signalement des erreurs, les méthodes de type de données xml génèrent une erreur unique au format suivant :

Msg errorNumber, Level levelNumber, State stateNumber:
XQuery [database.table.method]: description_of_error

Par exemple :

Msg 2396, Level 16, State 1:
XQuery [xmldb_test.xmlcol.query()]: Attribute may not appear outside of an element

Vérifications des singletons

Les étapes d'emplacement, les paramètres de fonction et les opérateurs qui réclament des singletons renverront une erreur lorsque le compilateur n'arrive pas à savoir si la présence d'un singleton est garantie lors de l'exécution. Ce problème se produit souvent avec des données non typées. Par exemple, la recherche d'un attribut exige un élément parent unique. Un nombre ordinal qui sélectionne un nœud parent unique suffit. L’évaluation d’une combinaison node()-value() pour extraire des valeurs d’attribut ne nécessite pas de spécification ordinale. comme le montre l'exemple suivant.

Exemple : Singleton connu

Dans cet exemple, la méthode nodes() génère une ligne distincte pour chaque élément <book>. La méthode value() qui est évaluée sur un nœud <book> extrait la valeur de @genre qui, puisqu’il s’agit d’un attribut, est un singleton.

SELECT nref.value('@genre', 'VARCHAR(max)') LastName
FROM T CROSS APPLY xCol.nodes('//book') AS R(nref)

Le schéma XML sert à vérifier le type en cas de code XML typé. Si un nœud est spécifié en tant que singleton dans le schéma XML, le compilateur utilise cette information et aucune erreur ne se produit. Dans le cas contraire, un nombre ordinal sélectionnant un nœud unique est requis. En particulier, l’utilisation de l’axe descendant-or-self (//), comme dans /book//title, perd l’inférence de cardinalité de singleton pour l’élément <title>, même si le schéma XML le spécifie. Vous devez par conséquent le réécrire sous la forme (/book//title)[1].

Il faut toujours garder à l’esprit la différence entre //first-name[1] et (//first-name)[1] pour la vérification du type. Le premier retourne une séquence de nœuds <first-name>, où chaque nœud est le nœud <first-name> le plus à gauche de ses frères. Le deuxième retourne le premier nœud <first-name> singleton dans l’ordre des documents de l’instance XML.

Exemple : Utilisation de value()

La requête suivante porte sur une colonne XML non typée et génère une erreur de compilation statique. La raison en est que value() attend un nœud singleton comme premier argument, et que le compilateur ne peut pas déterminer si un seul et unique nœud <last-name> est rencontré au moment de l’exécution :

SELECT xCol.value('//author/last-name', 'NVARCHAR(50)') LastName
FROM T

L'exemple suivant vous montre une solution à envisager :

SELECT xCol.value('//author/last-name[1]', 'NVARCHAR(50)') LastName
FROM T

Cependant, cette solution ne permet pas de remédier à l’erreur, car il peut y avoir plusieurs nœuds <author> dans chaque instance XML. Réécrit ainsi, l'exemple fonctionne :

SELECT xCol.value('(//author/last-name/text())[1]', 'NVARCHAR(50)') LastName
FROM T

Cette requête renvoie la valeur du premier élément <last-name> de chaque instance XML.

Voir aussi