ODBC-drivergedragsverandering bij het afhandelen van tekenconversies

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

De SQL Server 2012 (11.x) Native Client ODBC Driver (SQLNCLI11.dll) veranderde de manier waarop hij SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) en SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)) conversies doet. ODBC-functies, zoals SQLGetData, SQLBindCol, SQLBindParameter, geven (-4) SQL_NO_TOTAL als lengte/indicatorparameter terug wanneer de SQL Server Native Client ODBC-driver uit 2012 wordt gebruikt. Eerdere versies van de SQL Server Native Client ODBC-driver gaven een lengtewaarde terug, die onjuist kan zijn.

SQLGetData-gedrag

Veel Windows-functies laten je een buffergrootte van 0 specificeren en de teruggegeven lengte is de grootte van de teruggegeven data. Het volgende patroon is gebruikelijk voor Windows-programmeurs:

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  

SQLGetData mag echter in dit scenario niet worden gebruikt. Het volgende patroon mag niet worden gebruikt:

// 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 kan alleen worden aangeroepen om stukken van de daadwerkelijke data op te halen. Het gebruik van SQLGetData om de grootte van de data te krijgen is niet onondersteund.

Het volgende toont het effect van de driverwissel wanneer je het verkeerde patroon gebruikt. Deze applicatie doet een query-query in een varchar-kolom en binding als Unicode (SQL_UNICODE/SQL_WCHAR):

Vraag: select convert(varchar(36), '123')

SQLGetData(hstmt, SQL_WCHAR, ....., (SQLPOINTER*) 0x1, 0 , &iSize);   // Attempting to determine storage size needed  

Gebruik SQLGetData om de stukken van de data op te halen. (Pseudocode getoond:)

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 RETRIEVED (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  
      }  
   }  
}  

SQLBindCol-gedrag

Vraag: select convert(varchar(36), '1234567890')

SQLBindCol(... SQL_W_CHAR, ...)   // Only bound a buffer of WCHAR[4] - Expecting String Data Right Truncation behavior  

SQLBindParameter (OUTPUT Parameter Gedrag)

Vraag: create procedure spTest @p1 varchar(max) OUTPUT

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

SQLBindParameter(... SQL_W_CHAR, ...)   // Only bind up to first 64 characters  

Het uitvoeren van CHAR- en WCHAR-conversies

De SQL Server 2012 (11.x) Native Client ODBC-driver biedt verschillende manieren om CHAR- en WCHAR-conversies uit te voeren. De logica lijkt op het manipuleren van blobs (varchar(max), nvarchar(max), ...):

• Data wordt opgeslagen of afgekapt in de opgegeven buffer wanneer je bindt met SQLBindCol of SQLBindParameter.

• Als je niet bindt, kun je de data in chunks ophalen door SQLGetData en SQLParamData te gebruiken.

Verwante onderwerpen

• systeemeigen SQL Server-clientfuncties