Changement de comportement du pilote ODBC lors de la gestion des conversions de caractères

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.

Le SQL Server 2012 (11.x) Native Client ODBC Driver (SQLNCLI11.dll) a modifié la façon dont il effectue les conversions SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) et SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)). Les fonctions ODBC, telles que SQLGetData, SQLBindCol, SQLBindParameter, retournent (-4) SQL_NO_TOTAL en tant que paramètre length/indicateur lors de l’utilisation du pilote ODBC SQL Server 2012 Native Client. Les versions antérieures du pilote ODBC SQL Server Native Client ont retourné une valeur de longueur, qui peut être incorrecte.

Comportement de SQLGetData

La plupart des fonctions Windows vous permettent de spécifier une taille de mémoire tampon de 0, et la longueur retournée correspond à la taille des données renvoyées. Le motif suivant est bien connu des programmeurs Windows :

int iSize = 0;  
BYTE * pBuffer = NULL;  
GetMyFavoriteAPI(pBuffer, &iSize);   // Returns needed size in iSize  
pBuffer = new BYTE[iSize];   // Allocate buffer   
GetMyFavoriteAPI(pBuffer, &iSize);   // Retrieve actual data  

Toutefois, SQLGetData ne doit pas être utilisé dans ce scénario. Le motif suivant ne doit pas être utilisé :

// bad  
int iSize = 0;  
WCHAR * pBuffer = NULL;  
SQLGetData(hstmt, SQL_W_CHAR, ...., (SQLPOINTER*)0x1, 0, &iSize);   // Get storage size needed  
pBuffer = new WCHAR[(iSize/sizeof(WCHAR)) + 1];   // Allocate buffer  
SQLGetData(hstmt, SQL_W_CHAR, ...., (SQLPOINTER*)pBuffer, iSize, &iSize);   // Retrieve data  

SQLGetData ne peut être appelé que pour récupérer des segments de données réelles. L’utilisation de SQLGetData pour obtenir la taille des données n’est pas prise en charge.

Ce qui suit montre l'impact du changement de pilote lors de l'utilisation d'un motif incorrect. Cette application interroge une colonne varchar et une liaison au format Unicode (SQL_UNICODE/SQL_WCHAR) :

Requête : select convert(varchar(36), '123')

SQLGetData(hstmt, SQL_WCHAR, ....., (SQLPOINTER*) 0x1, 0 , &iSize);   // Attempting to determine storage size needed  
SQL Server Native Client version du pilote ODBC Résultat de longueur ou d'indicateur Description
SQL Server 2008 R2 (10.50.x) Native Client ou version antérieure 6 Le pilote a déduit par erreur que la conversion de CHAR en WCHAR serait obtenue en multipliant la longueur par 2.
SQL Server 2012 (11.x) Native Client (version 11.0.2100.60) ou ultérieure -4 (SQL_NO_TOTAL) Le pilote ne part plus du principe que la conversion de CHAR en WCHAR ou de WCHAR en CHAR correspond à une opération de multiplication (*2) ou de division (/2).

L’appel de SQLGetData ne retourne plus la longueur de la conversion attendue. Le pilote détecte la conversion vers ou depuis CHAR et WCHAR, puis retourne (-4) SQL_NO_TOTAL au lieu du comportement *2 ou /2 qui peut être incorrect.

Utilisez SQLGetData pour récupérer les segments des données. (Pseudo-code illustré :)

while( (SQL_SUCCESS or SQL_SUCCESS_WITH_INFO) == SQLFetch(...) ) {  
   SQLNumCols(...iTotalCols...)  
   for(int iCol = 1; iCol < iTotalCols; iCol++) {  
      WCHAR* pBufOrig, pBuffer = new WCHAR[100];  
      SQLGetData(.... iCol ... pBuffer, 100, &iSize);   // Get original chunk  
      while(NOT ALL DATA RETREIVED (SQL_NO_TOTAL, ...) ) {  
         pBuffer += 50;   // Advance buffer for data retrieved  
         // May need to realloc the buffer when you reach current size  
         SQLGetData(.... iCol ... pBuffer, 100, &iSize);   // Get next chunk  
      }  
   }  
}  

Comportement de SQLBindCol

Requête : select convert(varchar(36), '1234567890')

SQLBindCol(... SQL_W_CHAR, ...)   // Only bound a buffer of WCHAR[4] - Expecting String Data Right Truncation behavior  
SQL Server Native Client version du pilote ODBC Résultat de longueur ou d'indicateur Description
SQL Server 2008 R2 (10.50.x) Native Client ou version antérieure 20 SQLFetch signale qu’il existe une troncation sur le côté droit des données.

La longueur correspond à la longueur des données retournées, et non au contenu stocké (suppose une conversion *2 de CHAR en WCHAR, laquelle peut être incorrecte pour les glyphes).

Les données stockées dans la mémoire tampon sont 123\0. La mémoire tampon est alors certaine de se terminer par une valeur NULL.
SQL Server 2012 (11.x) Native Client (version 11.0.2100.60) ou ultérieure -4 (SQL_NO_TOTAL) SQLFetch signale qu’il existe une troncation sur le côté droit des données.

La longueur indique -4 (SQL_NO_TOTAL), car le reste des données n'a pas été converti.

Les données stockées dans la mémoire tampon sont 123\0. - La mémoire tampon est alors certaine de se terminer par une valeur NULL.

SQLBindParameter (comportement du paramètre OUTPUT)

Requête : create procedure spTest @p1 varchar(max) OUTPUT

select @p1 = replicate('B', 1234)

SQLBindParameter(... SQL_W_CHAR, ...)   // Only bind up to first 64 characters  
SQL Server Native Client version du pilote ODBC Résultat de longueur ou d'indicateur Description
SQL Server 2008 R2 (10.50.x) Native Client ou version antérieure 2468 SQLFetch ne retourne plus de données disponibles.

SQLMoreResults ne retourne plus de données disponibles.

La longueur indique la taille des données retournées du serveur, et non de celles stockées dans la mémoire tampon.

La mémoire tampon d'origine contient 63 octets et un terminateur NULL. La mémoire tampon est alors certaine de se terminer par une valeur NULL.
SQL Server 2012 (11.x) Native Client (version 11.0.2100.60) ou ultérieure -4 (SQL_NO_TOTAL) SQLFetch ne retourne plus de données disponibles.

SQLMoreResults ne retourne plus de données disponibles.

La longueur indique (-4) SQL_NO_TOTAL, car le reste des données n'a pas été converti.

La mémoire tampon d'origine contient 63 octets et un terminateur NULL. La mémoire tampon est alors certaine de se terminer par une valeur NULL.

Réalisation de conversions CHAR et WCHAR

Le pilote ODBC native client SQL Server 2012 (11.x) offre plusieurs façons d’effectuer des conversions CHAR et WCHAR. La logique est similaire à la manipulation d’objets blob (varchar(max), nvarchar(max), ...) :

  • Les données sont enregistrées ou tronquées dans la mémoire tampon spécifiée lors de la liaison avec SQLBindCol ou SQLBindParameter.

  • Si vous ne liez pas, vous pouvez récupérer les données en blocs à l’aide de SQLGetData et SQLParamData.

Voir aussi

Fonctionnalités de SQL Server Native Client