Exemples : Utilisation du mode AUTO
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
Les exemples suivants illustrent l'utilisation du mode AUTO. La plupart de ces requêtes sont spécifiées par rapport aux documents XML d’instructions de fabrication de vélos stockés dans la colonne Instructions de la table ProductModel dans l’exemple de base de données AdventureWorks2022.
Exemple : Récupérer les informations sur les détails des clients, des commandes et des commandes
Cette requête extrait les informations de client, de commande et de détail de commande relatives à un client spécifique.
USE AdventureWorks2022;
GO
SELECT Cust.CustomerID,
OrderHeader.CustomerID,
OrderHeader.SalesOrderID,
Detail.SalesOrderID, Detail.LineTotal, Detail.ProductID,
Product.Name,
Detail.OrderQty
FROM Sales.Customer AS Cust
INNER JOIN Sales.SalesOrderHeader AS OrderHeader
ON Cust.CustomerID = OrderHeader.CustomerID
INNER JOIN Sales.SalesOrderDetail AS Detail
ON OrderHeader.SalesOrderID = Detail.SalesOrderID
INNER JOIN Production.Product AS Product
ON Product.ProductID = Detail.ProductID
WHERE Cust.CustomerID IN (29672, 29734)
ORDER BY OrderHeader.CustomerID,
OrderHeader.SalesOrderID
FOR XML AUTO;
Étant donné que la requête identifie des alias de table Cust, OrderHeader, Detailet Product , des éléments correspondants sont générés par le mode AUTO . Là encore, l'ordre dans lequel les tables sont identifiées par les colonnes spécifiées dans la clause SELECT détermine la hiérarchie de ces éléments.
Le résultat partiel est le suivant.
<Cust CustomerID="29672">
<OrderHeader CustomerID="29672" SalesOrderID="43660">
<Detail SalesOrderID="43660" LineTotal="874.794000" ProductID="758" OrderQty="1">
<Product Name="Road-450 Red, 52" />
</Detail>
<Detail SalesOrderID="43660" LineTotal="419.458900" ProductID="762" OrderQty="1">
<Product Name="Road-650 Red, 44" />
</Detail>
</OrderHeader>
<OrderHeader CustomerID="29672" SalesOrderID="47660">
<Detail SalesOrderID="47660" LineTotal="469.794000" ProductID="765" OrderQty="1">
<Product Name="Road-650 Black, 58" />
</Detail>
</OrderHeader>
<OrderHeader CustomerID="29672" SalesOrderID="49857">
<Detail SalesOrderID="49857" LineTotal="44.994000" ProductID="852" OrderQty="1">
<Product Name="Women's Tights, S" />
</Detail>
</OrderHeader>
...
</Cust>
Exemple : Spécifier des fonctions GROUP BY et d’agrégation
La requête suivante renvoie des ID de client spécifiques et le nombre de commandes passées par chaque client.
USE AdventureWorks2022;
GO
SELECT C.CustomerID, COUNT(*) AS NoOfOrders
FROM Sales.Customer AS C
INNER JOIN Sales.SalesOrderHeader AS SOH
On C.CustomerID = SOH.CustomerID
GROUP BY C.CustomerID
FOR XML AUTO;
Voici le résultat partiel :
<I CustomerID="11000" NoOfOrders="3" />
<I CustomerID="11001" NoOfOrders="3" />
...
Exemple : Spécifier des colonnes calculées en mode AUTO
Cette requête renvoie des noms concaténés de clients spécifiques et les informations de commande. Étant donné que la colonne calculée est affectée au niveau le plus interne rencontré à ce stade, l’élément <SOH> de cet exemple. Les noms de clients concaténés sont ajoutés en tant qu’attributs de l’élément <SOH> dans le résultat.
USE AdventureWorks2022;
GO
SELECT P.FirstName + ' ' + P.LastName AS Name,
SOH.SalesOrderID
FROM Sales.Customer AS C
INNER JOIN Sales.SalesOrderHeader AS SOH
ON C.CustomerID = SOH.CustomerID
INNER JOIN Person.Person AS P
ON P.BusinessEntityID = C.PersonID
FOR XML AUTO;
Voici le résultat partiel :
<SOH Name="Jon Yang" SalesOrderID="43793" />
<SOH Name="Eugene Huang" SalesOrderID="43767" />
Pour récupérer les éléments ayant l’attribut <IndividualCustomer>Name qui contient chaque information d’en-tête de commande client en tant que sous-élément, la requête est réécrite à l’aide d’une sous-sélection. La sélection interne crée une table IndividualCustomer temporaire dans laquelle figure la colonne calculée qui contient les noms des différents clients. Cette table est ensuite jointe à la table SalesOrderHeader afin d'obtenir le résultat.
La Sales.Customer table stocke des informations client individuelles, y compris la PersonID valeur de ce client. Cette valeur PersonID permet ensuite de rechercher le nom de contact dans la table Person.Person .
SELECT IndividualCustomer.Name, SOH.SalesOrderID
FROM (SELECT FirstName+ ' '+LastName AS Name, C.PersonID, C.CustomerID
FROM Sales.Customer AS C, Person.Person AS P
WHERE C.PersonID = P.BusinessEntityID) AS IndividualCustomer
LEFT OUTER JOIN Sales.SalesOrderHeader AS SOH
ON IndividualCustomer.CustomerID = SOH.CustomerID
ORDER BY IndividualCustomer.CustomerID, SOH.CustomerID FOR XML AUTO;
Voici le résultat partiel :
<IndividualCustomer Name="Jon Yang">
<SOH SalesOrderID="43793" />
<SOH SalesOrderID="51522" />
<SOH SalesOrderID="57418" />
</IndividualCustomer>
...
Exemple : retourner des données binaires
Cette requête retourne une photo du produit de la table ProductPhoto . ThumbNailPhoto est une colonne varbinary (max) dans la table ProductPhoto . Par défaut, le mode AUTO renvoie vers les données binaires une référence, en l'occurrence une URL relative pointant vers la racine virtuelle de la base de données dans laquelle la requête est exécutée. L'attribut de clé ProductPhotoID doit être spécifié pour identifier l'image. Lors de la récupération d’une référence d’image comme illustré dans cet exemple, la clé primaire de la table doit également être spécifiée dans la SELECT clause pour identifier de manière unique une ligne.
SELECT ProductPhotoID, ThumbNailPhoto
FROM Production.ProductPhoto
WHERE ProductPhotoID = 70
FOR XML AUTO;
Voici le résultat obtenu :
<Production.ProductPhoto
ProductPhotoID="70"
ThumbNailPhoto= "dbobject/Production.ProductPhoto[@ProductPhotoID='70']/@ThumbNailPhoto" />
La même requête est exécutée avec l'option BINARY BASE64 . Elle renvoie les données binaires dans un format encodé en base 64.
SELECT ProductPhotoID, ThumbNailPhoto
FROM Production.ProductPhoto
WHERE ProductPhotoID = 70
FOR XML AUTO, BINARY BASE64;
Voici le résultat obtenu :
<Production.ProductPhoto ProductPhotoID="70" ThumbNailPhoto="Base64 encoded photo" />
Par défaut, lorsque vous utilisez le mode AUTO pour extraire des données binaires, une référence à une URL relative pointant vers la racine virtuelle de la base de données dans laquelle la requête a été exécutée est renvoyée à la place des données binaires. Cela se produit si l’option BINARY BASE64 n’est pas spécifiée.
Lorsque le mode AUTO retourne une référence d’URL aux données binaires dans des bases de données qui ne respectent pas la casse, où un nom de table ou de colonne spécifié dans la requête ne correspond pas au nom de la table ou de la colonne dans la base de données, la requête s’exécute. Toutefois, le cas retourné dans la référence ne sera pas cohérent. Par exemple :
SELECT ProductPhotoID, ThumbnailPhoto
FROM Production.ProductPhoto
WHERE ProductPhotoID=70
FOR XML AUTO;
Voici le résultat obtenu :
<Production.PRODUCTPHOTO
PRODUCTPHOTOID="70"
THUMBNAILPHOTO= "dbobject/Production.PRODUCTPHOTO[@ProductPhotoID='70']/@ThumbNailPhoto" />
Il peut s’agir d’un problème en particulier lorsque dbobject les requêtes sont exécutées sur une base de données sensible à la casse. Pour l'éviter, la casse du nom de table ou de colonne spécifié dans les requêtes doit correspondre à celle du nom de table ou de colonne défini dans la base de données.
Exemple : Comprendre l’encodage
Cet exemple montre les différents encodages qui se produisent dans les résultats.
Créez cette table :
CREATE TABLE [Special Chars] (Col1 char(1) primary key, [Col#&2] varbinary(50));
Ajoutez les données suivantes à la table :
INSERT INTO [Special Chars] VALUES ('&', 0x20), ('#', 0x20);
Cette requête renvoie les données de la table. Le mode FOR XML AUTO est spécifié. Les données binaires sont renvoyées sous forme de référence.
SELECT * FROM [Special Chars] FOR XML AUTO;
Voici le résultat obtenu :
<Special_x0020_Chars Col1="#"
Col_x0023__x0026_2="dbobject/Special_x0020_Chars[@Col1='#']/@Col_x0023__x0026_2"
/>
<Special_x0020_Chars Col1="&"
Col_x0023__x0026_2="dbobject/Special_x0020_Chars[@Col1='&']/@Col_x0023__x0026_2"
/>
Voici le processus pour encoder des caractères spéciaux dans le résultat :
Dans le résultat de la requête, les caractères spéciaux XML et URL qui se trouvent dans les noms d'éléments et d'attributs renvoyés sont encodés avec la valeur hexadécimale du caractère Unicode correspondant. Dans le résultat précédent, le nom
<Special Chars>de l’élément est retourné en tant que<Special_x0020_Chars>. Le nom<Col#&2>de l’attribut est retourné en tant que<Col_x0023__x0026_2>. Les caractères spéciaux XML et URL sont encodés.Si les valeurs des éléments ou attributs contiennent l’une des cinq entités de caractères XML standard (', « », <>et &), ces caractères XML spéciaux sont toujours encodés à l’aide de l’encodage de caractères XML. Dans le résultat précédent, la valeur dans la valeur
&de l’attribut<Col1>est encodée en tant que&. Toutefois, le caractère # reste #, car il s’agit d’un caractère XML valide et non d’un caractère XML spécial.Si les valeurs des éléments ou attributs contiennent des caractères d’URL spéciaux qui ont une signification particulière dans l’URL, ils sont encodés uniquement dans la valeur d’URL DBOBJECT et sont encodés uniquement lorsque le caractère spécial fait partie d’un nom de table ou de colonne. Dans le résultat, le caractère «
#» qui fait partie du nom de tableCol#&2est encodé sous la forme_x0023_ in the DBOJBECT URL.
Voir aussi
Commentaires
Bientôt disponible : pendant toute l’année 2024, nous allons éliminer progressivement Problèmes GitHub comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, voir : https://aka.ms/ContentUserFeedback.
Soumettre et afficher des commentaires pour