Utilisation de types de données XML dans SQL Server clients natifs
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Important
SQL Server Native Client (souvent abrégé en SNAC) a été supprimé dans SQL Server 2022 (16.x) et SQL Server Management Studio 19 (SSMS). SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB pour SQL Server (SQLOLEDB) hérité ne sont pas recommandés dans les nouveaux développements. Utilisez à la place le nouveau Microsoft OLE DB Driver (MSOLEDBSQL) pour SQL Server ou le Microsoft ODBC Driver for SQL Server le plus récent. Pour SQLNCLI fourni en tant que composant du moteur de base de données SQL Server (versions 2012 à 2019), consultez cette exception de support du cycle de vie.
SQL Server 2005 (9.x) a introduit un type de données xml qui vous permet de stocker des documents et des fragments XML dans une base de données SQL Server. Le type de données xml est intégré dans SQL Server et s’apparente à certains égards à d’autres types intégrés, comme int et varchar. Tout comme les autres types intégrés, vous pouvez utiliser le type de données xml en tant que type de colonne quand vous créez une table ou en tant que type de variable, type de paramètre ou type de retour de fonction ou bien dans des fonctions CAST et CONVERT.
Éléments de programmation à prendre en considération
XML peut être autodescriptif dans ce sens où il peut inclure un en-tête XML (facultatif) qui spécifie l'encodage du document. Par exemple :
<?xml version="1.0" encoding="windows-1252"?><doc/>
Le standard XML décrit la manière dont un processeur XML est capable de détecter l'encodage utilisé pour un document en examinant les premiers octets du document. Parfois, il est possible que l'encodage spécifié par l'application soit en conflit avec celui spécifié par le document. Dans le cadre des documents passés en tant que paramètres liés, XML est traité en tant que données binaires par SQL Server ; aucune conversion n'est donc réalisée et l'analyseur XML peut sans problème exploiter l'encodage spécifié dans le document. Toutefois, pour les données XML liées en tant que données de type WSTR, l'application doit alors garantir que le document est encodé au format Unicode. Ceci peut impliquer le chargement du document dans un DOM, le passage de l'encodage en Unicode et la sérialisation du document. Si cela n'est pas fait, des conversions de données peuvent se produire et générer simultanément des données XML non valides ou endommagées.
Il existe également un risque potentiel de conflit lorsque vous spécifiez du XML dans des littéraux. Par exemple, les données suivantes ne sont pas valides :
INSERT INTO xmltable(xmlcol) VALUES('<?xml version="1.0" encoding="UTF-16"?><doc/>')
INSERT INTO xmltable(xmlcol) VALUES(N'<?xml version="1.0" encoding="UTF-8"?><doc/>')
Fournisseur OLE DB SQL Server Native Client
DBTYPE_XML est un nouveau type de données spécifique à XML dans le fournisseur OLE DB SQL Server Native Client. De plus, vous pouvez accéder aux données XML par le biais des types OLE DB existants DBTYPE_BYTES, DBTYPE_WSTR, DBTYPE_BSTR, DBTYPE_XML, DBTYPE_STR, DBTYPE_VARIANT et DBTYPE_IUNKNOWN. Les données stockées dans des colonnes de type XML peuvent être récupérées à partir d’une colonne d’un ensemble de lignes du fournisseur OLE DB SQL Server Native Client dans les formats suivants :
Chaîne de texte
ISequentialStream
Notes
Le SQL Server Native Client fournisseur OLE DB n’inclut pas de lecteur SAX, mais L’ISequentialStream peut être facilement transmis aux objets SAX et DOM dans MSXML.
ISequentialStream doit être utilisé pour la récupération de documents XML volumineux. Les mêmes techniques utilisées pour les types de valeur élevée s'appliquent également à XML. Pour plus d’informations, consultez la section Utilisation de types de valeur élevée.
Les données stockées dans les colonnes de type XML dans un ensemble de lignes peuvent également être récupérées, insérées ou mises à jour par une application via les interfaces classiques, comme IRow::GetColumns, IRowChange::SetColumns et ICommand::Execute. Comme pour le cas de récupération, un programme d’application peut passer une chaîne de texte ou un ISequentialStream au SQL Server Native Client fournisseur OLE DB.
Notes
Pour envoyer des données XML dans un format de chaîne par le biais de l’interface ISequentialStream, vous devez obtenir ISequentialStream en spécifiant DBTYPE_IUNKNOWN et affecter la valeur Null à son argument pObject dans la liaison.
Lorsque des données XML extraites apparaissent tronquées en raison d'une mémoire tampon du consommateur trop petite, la longueur retournée peut être 0xffffffff, ce qui signifie qu'elle est n'est pas connue. Ceci est cohérent avec son implémentation en tant que type de données transmis au client sans envoyer des informations de longueur avant les données réelles. Dans certains cas, la longueur réelle peut être retournée lorsque le fournisseur a mis en mémoire tampon la valeur entière, comme IRowset::GetData et où la conversion des données est effectuée.
Les données XML envoyées à SQL Server sont traitées en tant que données binaires par le serveur. Ceci empêche tout risque de conversion et permet à l'analyseur XML de détecter automatiquement l'encodage XML. Un plus large éventail de documents XML (par exemple, les documents encodés au format UTF-8) peuvent être acceptés en tant qu'entrées dans SQL Server.
Si du contenu XML d'entrée est lié en tant que données du type DBTYPE_WSTR, l'application doit garantir qu'il est déjà encodé en Unicode pour éviter tout risque d'altération suite à des conversions de données indésirables.
Liaisons de données et forçages de type
Le tableau suivant décrit la liaison et le forçage de type survenant quand vous utilisez les types de données répertoriés avec le type de données xml SQL Server.
| Type de données | Vers le serveur XML |
Vers le serveur Non-XML |
Depuis le serveur XML |
Depuis le serveur Non-XML |
|---|---|---|---|---|
| DBTYPE_XML | Transfert direct6,7 | Erreur1 | OK11, 6 | Erreur8 |
| DBTYPE_BYTES | Transfert direct6,7 | N/A2 | OK 11, 6 | N/A 2 |
| DBTYPE_WSTR | Transfert direct6,10 | N/A 2 | OK4, 6, 12 | N/A 2 |
| DBTYPE_BSTR | Transfert direct6,10 | N/A 2 | OK 3 | N/A 2 |
| DBTYPE_STR | OK6, 9, 10 | N/A 2 | OK5, 6, 12 | N/A 2 |
| DBTYPE_IUNKNOWN | Flux d’octets via ISequentialStream7 | N/A 2 | Flux d’octets via ISequentialStream11 | N/A 2 |
| DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) | Transfert direct6,7 | N/A 2 | N/A | N/A 2 |
| DBTYPE_VARIANT (VT_BSTR) | Transfert direct6,10 | N/A 2 | OK3 | N/A 2 |
1Si un type de serveur autre que DBTYPE_XML est spécifié avec ICommandWithParameters::SetParameterInfo et si le type d’accesseur est DBTYPE_XML, une erreur se produit lors de l’exécution de l’instruction (DB_E_ERRORSOCCURRED, l’état du paramètre est DBSTATUS_E_BADACCESSOR) ; sinon, les données sont envoyées au serveur, mais celui-ci retourne une erreur indiquant qu’aucune conversion implicite de XML vers le type de données du paramètre n’a lieu.
2 Au-delà de la portée de cette rubrique.
3Le format est UTF-16. Absence de marque d’ordre d’octet (BOM), de spécification d’encodage et de marque de fin Null.
4Le format est UTF-16. Absence de marque d’ordre d’octet (BOM), de spécification d’encodage et de marque de fin Null.
5Le format employé est celui de caractères multioctets encodés dans la page de codes du client avec une marque de fin Null. Toute conversion à partir de code Unicode sur le serveur risque d'endommager les données. Cette liaison est donc fortement déconseillée.
6BY_REF peut être utilisé.
7Les données UTF-16 doivent commencer par une marque d’ordre d’octet. Si cela n'est pas le cas, il est possible que l'encodage ne soit pas correctement reconnu par le serveur.
8La validation peut avoir lieu au moment de créer l’accesseur ou au moment de l’extraction. L'erreur est DB_E_ERRORSOCCURRED et l'état de la liaison est défini sur DBBINDSTATUS_UNSUPPORTEDCONVERSION.
9Les données sont converties au format Unicode à l’aide de la page de codes du client avant d’être envoyées au serveur. Si l'encodage du document ne correspond pas à la page de codes du client, les données risquent d'être endommagées. Cette liaison est donc fortement déconseillée.
10Une marque d’ordre d’octet est toujours ajoutée aux données envoyées au serveur. Si les données commencent déjà par une marque d'ordre d'octet, deux marques d'ordre d'octet apparaissent alors au démarrage de la mémoire tampon. Le serveur utilise la première marque d’ordre d’octet pour reconnaître l’encodage en tant qu’encodage UTF-16, puis l’ignore. La deuxième marque d'ordre d'octet est interprétée comme un espace insécable de largeur nulle.
11Le format est UTF-16. Absence de spécification d’encodage et ajout d’une marque d’ordre d’octet aux données reçues du serveur. Si le serveur retourne une chaîne vide, une marque d’ordre d’octet est quand même retournée à l’application. Si la longueur de la mémoire tampon est un nombre impair d’octets, les données sont tronquées comme il se doit. Si la valeur entière est retournée en plusieurs segments, vous pouvez les concaténer pour reconstituer la valeur correcte.
12 Si la longueur de la mémoire tampon est inférieure à deux caractères, c’est-à-dire que l’espace est insuffisant pour l’arrêt null, une erreur de dépassement de capacité est signalée.
Notes
Aucune donnée n'est retournée pour les valeurs XML NULL.
Le standard XML exigent que les données XML encodées UTF-16 commencent par une marque d'ordre d'octet (BOM), soit le code de caractère UTF-16 0xFEFF. Lorsque vous utilisez des liaisons WSTR et BSTR, SQL Server Native Client ne nécessite pas ou n’ajoute pas de nomenclature, car l’encodage est impliqué par la liaison. Dans le cadre des liaisons BYTES, XML ou IUNKNOWN, l'objectif recherché est la simplification de l'utilisation d'autres processeurs et systèmes de stockage XML. Dans ce cas, une marque d'ordre d'octet doit être présente avec les données XML encodées UTF-16 et l'application n'a pas à se soucier de l'encodage réel puisque la majorité des processeurs XML (y compris SQL Server) détectent l'encodage par inspection des premiers octets de la valeur. Les données XML reçues de SQL Server Native Client à l’aide de liaisons BYTES, XML ou IUNKNOWN sont toujours encodées en UTF-16 avec une nomenclature et sans déclaration d’encodage incorporée.
Les conversions de données fournies par les services principaux OLE DB (IDataConvert) ne s’appliquent pas à DBTYPE_XML.
La validation s'effectue lorsque les données sont envoyées au serveur. La validation côté client et les modifications d'encodage doivent être gérées par votre application et il est fortement recommandé que vous ne traitiez pas les données XML directement mais utilisiez à la place un lecteur DOM ou SAX pour leur traitement.
Les types DBTYPE_NULL et DBTYPE_EMPTY peuvent être liés pour des paramètres d'entrée mais pas pour des paramètres de résultats ou pour des sorties. S'ils sont liés pour des paramètres d'entrée, l'état doit être défini sur DBSTATUS_S_ISNULL ou DBSTATUS_S_DEFAULT.
DBTYPE_XML peut être converti en DBTYPE_EMPTY et DBTYPE_NULL, DBTYPE_EMPTY peut être converti en DBTYPE_XML mais DBTYPE_NULL ne peut pas être converti en DBTYPE_XML, ce qui est cohérent avec DBTYPE_WSTR.
DBTYPE_IUNKNOWN est une liaison prise en charge (voir le tableau ci-dessus) mais il n'existe aucune conversion entre DBTYPE_XML et DBTYPE_IUNKNOWN. DBTYPE_IUNKNOWN ne peut pas être utilisé avec DBTYPE_BYREF.
Ajout et modifications dans les ensembles de lignes OLE DB
SQL Server Native Client ajoute de nouvelles valeurs ou des modifications à la plupart des ensembles de lignes de schéma OLE DB principaux.
Ensembles de lignes de schéma COLUMNS et PROCEDURE_PARAMETERS
Les ajouts réalisés dans les ensembles de lignes de schéma COLUMNS et PROCEDURE_PARAMETERS incluent les colonnes suivantes.
| Nom de la colonne | Type | Description |
|---|---|---|
| SS_XML_SCHEMACOLLECTION_CATALOGNAME | DBTYPE_WSTR | Nom d'un catalogue dans lequel une collection de schémas XML est définie. Possède la valeur NULL pour une colonne non XML ou une colonne XML non typée. |
| SS_XML_SCHEMACOLLECTION_SCHEMANAME | DBTYPE_WSTR | Nom d'un schéma dans lequel une collection de schémas XML est définie. Possède la valeur NULL pour une colonne non XML ou une colonne XML non typée. |
| SS_XML_SCHEMACOLLECTIONNAME | DBTYPE_WSTR | Nom de la collection de schémas XML. Possède la valeur NULL pour une colonne non XML ou une colonne XML non typée. |
Ensemble de lignes de schéma PROVIDER_TYPES
Dans l’ensemble de lignes de schéma PROVIDER_TYPES, la valeur COLUMN_SIZE est 0 pour le type de données xml et la valeur DATA_TYPE est DBTYPE_XML.
Ensemble de lignes de schéma SS_XMLSCHEMA
Un nouvel ensemble de lignes de schéma SS_XMLSCHEMA permettant d'extraire des informations de schéma XML est proposé pour les clients. L'ensemble de lignes SS_XMLSCHEMA contient les colonnes suivantes.
| Nom de la colonne | Type | Description |
|---|---|---|
| SCHEMACOLLECTION_CATALOGNAME | DBTYPE_WSTR | Catalogue auquel une collection XML appartient. |
| SCHEMACOLLECTION_SCHEMANAME | DBTYPE_WSTR | Schéma auquel une collection XML appartient. |
| SCHEMACOLLECTIONNAME | DBTYPE_WSTR | Nom d’une collection de schémas XML pour les colonnes XML typées, valeur Null dans le cas contraire. |
| TARGETNAMESPACEURI | DBTYPE_WSTR | Espace de noms cible d'un schéma XML. |
| SCHEMACONTENT | DBTYPE_WSTR | Contenu du schéma XML. |
L'étendue de chaque schéma XML est définie par nom de catalogue, nom de schéma, nom de collection de schémas et par URI (Uniform Resource Identifier) d'espace de noms cible. Qui plus est, un nouveau GUID nommé DBSCHEMA_XML_COLLECTIONS est également défini. Le nombre de restrictions et les colonnes restreintes pour l'ensemble de lignes de schéma SS_XMLSCHEMA sont définis comme suit.
| GUID | Nombre de restrictions | Colonnes restreintes |
|---|---|---|
| DBSCHEMA_XML_COLLECTIONS | 4 | SCHEMACOLLECTION_CATALOGNAME SCHEMACOLLECTION_SCHEMANAME SCHEMACOLLECTIONNAME TARGETNAMESPACEURI |
Ajouts et modifications effectués dans le jeu de propriétés OLE DB
SQL Server Native Client ajoute de nouvelles valeurs ou des modifications à la plupart des principaux jeux de propriétés OLE DB.
Jeu de propriétés DBPROPSET_SQLSERVERPARAMETER
Pour prendre en charge le type de données xml via OLE DB, SQL Server Native Client implémente le nouveau jeu de propriétés DBPROPSET_SQLSERVERPARAMETER, qui contient les valeurs suivantes.
| Nom | Type | Description |
|---|---|---|
| SSPROP_PARAM_XML_SCHEMACOLLECTION_CATALOGNAME | DBTYPE_WSTR | Nom d'un catalogue (base de données) dans lequel une collection de schémas XML est définie. Une des trois parties qui composent l’identificateur de nom SQL. |
| SSPROP_PARAM_XML_SCHEMACOLLECTION_SCHEMANAME | DBTYPE_WSTR | Nom d'un schéma XML dans la collection de schémas. Une des trois parties qui composent l'identificateur de nom SQL. |
| SSPROP_PARAM_XML_SCHEMACOLLECTIONNAME | DBTYPE_WSTR | Nom de la collection de schémas XML dans le catalogue. Une des trois parties qui composent l'identificateur de nom SQL. |
Jeu de propriétés DBPROPSET_SQLSERVERCOLUMN
Pour prendre en charge la création de tables dans l’interface ITableDefinition, SQL Server Native Client ajoute trois nouvelles colonnes au jeu de propriétés DBPROPSET_SQLSERVERCOLUMN.
| Nom | Type | Description |
|---|---|---|
| SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME | VT_BSTR | Pour les colonnes XML typées, cette propriété est une chaîne qui spécifie le nom du catalogue où le schéma XML est stocké. Pour d'autres types de colonnes, cette propriété retourne une chaîne vide. |
| SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME | VT_BSTR | Pour les colonnes XML typées, cette propriété est une chaîne qui spécifie le nom de schéma XML qui définit cette colonne. |
| SSPROP_COL_XML_SCHEMACOLLECTIONNAME | VT_BSTR | Pour les colonnes XML typées, cette propriété est une chaîne qui spécifie le nom de la collection de schémas XML qui définit la valeur. |
De même que les valeurs SSPROP_PARAM, toutes ces propriétés sont facultatives et sont vides par défaut. Les valeurs SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME et SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME peuvent être spécifiées uniquement si la valeur SSPROP_COL_XML_SCHEMACOLLECTIONNAME est spécifiée. Lorsque vous passez des données XML au serveur, si ces valeurs sont incluses, leur raison d'être (validité) est vérifiée par rapport à la base de données actuelle et les données d'instance sont vérifiées par rapport au schéma. Dans tous les cas, pour être valides, elles doivent toutes être vides ou renseignées.
Ajout et modifications dans l'interface OLE DB
SQL Server Native Client ajoute de nouvelles valeurs ou des modifications à de nombreuses interfaces OLE DB principales.
Interface ISSCommandWithParameters
Pour prendre en charge le type de données xml via OLE DB, SQL Server Native Client implémente un certain nombre de modifications, notamment l’ajout de l’interface ISSCommandWithParameters. Cette nouvelle interface hérite de l’interface OLE DB ICommandWithParameters principale. En plus des trois méthodes héritées de ICommandWithParameters ; GetParameterInfo, MapParameterNames et SetParameterInfo ; ISSCommandWithParameters fournit les méthodes GetParameterProperties et SetParameterProperties utilisées pour gérer des types de données spécifiques au serveur.
Notes
L’interface ISSCommandWithParameters exploite également la nouvelle structure SSPARAMPROPS.
Interface IColumnsRowset
SQL Server Native Client ajoute les colonnes SQL Server suivantes à l’ensemble de lignes retourné par la méthode IColumnRowset::GetColumnsRowset. Ces colonnes contiennent le nom en trois parties d'une collection de schémas XML. Dans le cas des colonnes non XML ou des colonnes XML non typées, ces trois colonnes possèdent toutes la valeur NULL par défaut.
| Nom de la colonne | Type | Description |
|---|---|---|
| DBCOLUMN_SS_XML_SCHEMACOLLECTION_CATALOGNAME | DBTYPE_WSTR | Catalogue auquel une collection de schémas XML appartient. Possède la valeur NULL sinon. |
| DBCOLUMN_SS_XML_SCHEMACOLLECTION_SCHEMANAME | DBTYPE_WSTR | Schéma auquel une collection de schémas XML appartient. Possède la valeur NULL sinon. |
| DBCOLUMN_SS_XML_SCHEMACOLLECTIONNAME | DBTYPE_WSTR | Nom d'une collection de schémas XML pour les colonnes XML typées, valeur NULL dans le cas contraire. |
Interface IRowset
Une instance XML est récupérée d’une colonne XML au moyen de la méthode IRowset::GetData. En fonction de la liaison spécifiée par le client, une instance XML peut être extraite en tant que type DBTYPE_BSTR, DBTYPE_WSTR, DBTYPE_VARIANT, DBTYPE_XML, DBTYPE_STR ou DBTYPE_BYTES, ou bien en tant qu'interface via DBTYPE_IUNKNOWN. Si le consommateur spécifie DBTYPE_BSTR, DBTYPE_WSTR ou DBTYPE_VARIANT, le fournisseur convertit l'instance XML d'après le type demandé par l'utilisateur et le stocke à l'emplacement précisé dans la liaison correspondante.
Si le consommateur spécifie DBTYPE_IUNKNOWN et affecte la valeur Null à l’argument pObject, ou affecte IID_ISequentialStream à l’argument pObject, le fournisseur retourne une interface ISequentialStream au consommateur afin que ce dernier puisse extraire les données XML de la colonne. ISequentialStream retourne ensuite les données XML sous forme de flux de caractères Unicode.
Au moment de retourner une valeur XML liée à DBTYPE_IUNKNOWN, le fournisseur signale une valeur de taille sizeof (IUnknown *). Notez que ceci est cohérent avec l'approche adoptée lorsqu'une colonne est liée en tant que DBTYPE_IUnknown ou DBTYPE_IDISPATCH et par DBTYPE_IUNKNOWN/ISequentialStream lorsque la taille de colonne exacte est impossible à déterminer.
Interface IRowsetChange
Il existe deux moyens pour un consommateur de mettre à jour une instance XML dans une colonne. Le premier est de faire appel à l’objet de stockage ISequentialStream créé par le fournisseur. Le consommateur peut appeler la méthode ISequentialStream::Write pour mettre à jour directement l’instance XML retournée par le fournisseur.
La deuxième approche repose sur la méthode IRowsetChange::SetData ou IRowsetChange::InsertRow. Dans ce cas précis, une instance XML issue de la mémoire tampon du consommateur peut être spécifiée dans une liaison de type DBTYPE_BSTR, DBTYPE_WSTR, DBTYPE_VARIANT, DBTYPE_XML ou DBTYPE_IUNKNOWN.
Dans le cas du type DBTYPE_BSTR, DBTYPE_WSTR ou DBTYPE_VARIANT, le fournisseur stocke l'instance XML résidant dans la mémoire tampon du consommateur à l'intérieur de la colonne appropriée.
Dans le cas de DBTYPE_IUNKNOWN/ISequentialStream, si le consommateur ne spécifie aucun objet de stockage, le consommateur doit créer un objet ISequentialStream à l’avance, lier le document XML à l’objet, puis passer l’objet au fournisseur via la méthode IRowsetChange::SetData . Le consommateur peut également créer un objet de stockage, affecter IID_ISequentialStream à l’argument pObject, créer un objet ISequentialStream, puis passer l’objet ISequentialStream à la méthode IRowsetChange::SetData. Dans les deux cas, le fournisseur peut récupérer l’objet XML via l’objet ISequentialStream et l’insérer dans une colonne appropriée.
Interface IRowsetUpdate
L’interface IRowsetUpdate fournit les fonctionnalités nécessaires dans le cas de mises à jour différées. Les données mises à la disposition des ensembles de lignes ne sont pas mises à la disposition d’autres transactions tant que le consommateur n’appelle pas la méthode IRowsetUpdate:Update .
Interface IRowsetFind
La méthode IRowsetFind::FindNextRow ne fonctionne pas avec le type de données xml. Quand vous appelez IRowsetFind::FindNextRow et que l’argument hAccessor spécifie une colonne de type DBTYPE_XML, la valeur DB_E_BADBINDINFO est retournée. Cette situation se produit quel que soit le type de colonne recherché. Pour tous les autres types de liaisons, la méthode FindNextRow échoue avec DB_E_BADCOMPAREOP si la colonne dans laquelle effectuer la recherche affiche le type de données xml.
Pilote ODBC SQL Server Native Client
Dans le pilote ODBC SQL Server Native Client, un certain nombre de modifications ont été apportées à différentes fonctions pour prendre en charge le type de données xml.
SQLColAttribute
La fonction SQLColAttribute a trois nouveaux identificateurs de champ, à savoir SQL_CA_SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SQL_CA_SS_XML_SCHEMACOLLECTION_SCHEMA_NAME et SQL_CA_SS _XML_SCHEMACOLLECTION_NAME.
Le pilote ODBC SQL Server Native Client signale SQL_SS_LENGTH_UNLIMITED pour les colonnes SQL_DESC_DISPLAY_SIZE et SQL_DESC_LENGTH.
SQLColumns
La fonction SQLColumns comporte trois nouvelles colonnes: SS_XML_SCHEMACOLLECTION_CATALOG_NAME, SS_XML_SCHEMACOLLECTION_SCHEMA_NAME et SS_XML_SCHEMACOLLECTION_NAME. La colonne TYPE_NAME existante est utilisée pour indiquer le nom du type XML et la valeur DATA_TYPE d'une colonne ou d'un paramètre de type XML est SQL_SS_XML.
Le pilote ODBC SQL Server Native Client signale SQL_SS_LENGTH_UNLIMITED pour les valeurs COLUMN_SIZE et CHAR_OCTET_LENGTH.
SQLDescribeCol
Le pilote ODBC SQL Server Native Client signale SQL_SS_LENGTH_UNLIMITED lorsque la taille de colonne ne peut pas être déterminée dans la fonction SQLDescribeCol.
SQLGetTypeInfo
Le pilote ODBC SQL Server Native Client signale SQL_SS_LENGTH_UNLIMITED comme COLUMN_SIZE maximale pour le type de données xml dans la fonction SQLGetTypeInfo.
SQLProcedureColumns
La fonction SQLProcedureColumns a les mêmes ajouts de colonnes que la fonction SQLColumns .
Le pilote ODBC SQL Server Native Client signale SQL_SS_LENGTH_UNLIMITED comme COLUMN_SIZE maximale pour le type de données xml.
Conversions prises en charge
Lorsque vous procédez à des conversions entre des types de données SQL vers C, SQL_C_WCHAR, SQL_C_BINARY et SQL_C_CHAR peuvent tous être convertis en SQL_SS_XML avec les caractéristiques suivantes :
SQL_C_WCHAR : format UTF-16, absence de marque d'ordre d'octet (BOM), marque de fin null.
SQL_C_BINARY : format UTF-16, absence de marque de fin null. Une marque d'ordre d'octet (BOM) est ajoutée aux données reçues du serveur. Si le serveur retourne une chaîne vide, une marque d'ordre d'octet est quand même retournée à l'application. Si la longueur de la mémoire tampon est un nombre impair d'octets, les données sont tronquées comme il se doit. Si la valeur tout entière est retournée en plusieurs segments, vous pouvez les concaténer pour reconstituer la valeur correcte.
SQL_C_CHAR : le format employé est celui de caractères multioctets encodés dans la page de codes du client avec une marque de fin null. Toute conversion à partir de code UTF-16 sur le serveur risque d'endommager les données. Cette liaison est donc fortement déconseillée.
Lorsque vous procédez à des conversions entre des types de données C vers SQL, SQL_C_WCHAR, SQL_C_BINARY et SQL_C_CHAR peuvent tous être convertis en SQL_SS_XML avec les caractéristiques suivantes :
SQL_C_WCHAR : une marque d'ordre d'octet (BOM) est toujours ajoutée aux données envoyées au serveur. Si les données commencent déjà par une marque d'ordre d'octet, deux marques d'ordre d'octet apparaissent alors au démarrage de la mémoire tampon. Le serveur utilise la première marque d'ordre d'octet pour reconnaître l'encodage en tant qu'encodage UTF-16, puis l'ignore. La deuxième marque d'ordre d'octet est interprétée comme un espace insécable de largeur nulle.
SQL_C_BINARY : aucune conversion n’est effectuée et les données sont transmises au serveur « telles quelles ». Les données UTF-16 doivent commencer par une nomenclature ; si ce n’est pas le cas, l’encodage peut ne pas être correctement reconnu par le serveur.
SQL_C_CHAR : les données sont converties en UTF-16 sur le client et envoyées au serveur uniquement en tant que SQL_C_WCHAR (avec ajout d'une marque d'ordre d'octet compris). Si le contenu XML n'est pas encodé dans la page de codes du client, les données risquent d'être endommagées.
Le standard XML exigent que les données XML encodées UTF-16 commencent par une marque d'ordre d'octet (BOM), soit le code de caractère UTF-16 0xFEFF. Lors de l’utilisation d’une liaison SQL_C_BINARY, SQL Server Native Client ne nécessite pas ou n’ajoute pas d’ordre, car l’encodage est impliqué par la liaison. L'objectif recherché est la simplification de l'utilisation d'autres processeurs et systèmes de stockage XML. Dans ce cas, une nomenclature doit être présente avec du CODE XML encodé en UTF-16, et l’application n’a pas besoin de se préoccuper de l’encodage réel, car la majorité des processeurs XML (y compris SQL Server) déduisent l’encodage en inspectant les premiers octets de la valeur. Les données XML reçues de SQL Server Native Client à l’aide de liaisons SQL_C_BINARY sont toujours encodées en UTF-16 avec une nomenclature et sans déclaration d’encodage incorporée.
Voir aussi
Fonctionnalités de SQL Server Native Client
ISSCommandWithParameters (OLE DB)
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour