ODBC-drivrutinsbeteendeförändring vid hantering av teckenkonverteringar

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Den SQL Server 2012 (11.x) Native Client ODBC Driver (SQLNCLI11.dll) ändrade hur den gör SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) och SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX))-konverteringar. ODBC-funktioner, såsom SQLGetData, SQLBindCol, SQLBindParameter, returnerar (-4) SQL_NO_TOTAL som längd/indikatorparameter när man använder SQL Server 2012 Native Client ODBC-drivrutin. Tidigare versioner av SQL Server Native Client ODBC-drivrutinen returnerade ett längdvärde, vilket kan vara felaktigt.

SQLGetData-beteende

Många Windows-funktioner låter dig ange en buffertstorlek på 0 och den returnerade längden är storleken på den returnerade datan. Följande mönster är vanligt bland Windows-programmerare:

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 bör dock inte användas i detta scenario. Följande mönster bör inte användas:

// 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 endast anropas för att hämta bitar av faktisk data. Att använda SQLGetData för att få datastorleken är inte utan stöd.

Följande visar effekten av driverbytet när du använder fel mönster. Denna applikation frågar en varchar-kolumn och bindning som Unicode (SQL_UNICODE/SQL_WCHAR):

Fråga: select convert(varchar(36), '123')

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

Använd SQLGetData för att hämta databitarna. (Pseudokod visas:)

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-beteende

Fråga: select convert(varchar(36), '1234567890')

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

SQLBindParameter (OUTPUT-parameterbeteende)

Fråga: create procedure spTest @p1 varchar(max) OUTPUT

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

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

Utförande av CHAR- och WHAR-konverteringar

SQL Server 2012 (11.x) Native Client ODBC-drivrutinen erbjuder flera sätt att utföra CHAR- och WCHAR-konverteringar. Logiken liknar att manipulera blobs (varchar(max), nvarchar(max), ...):

• Data sparas eller trunkeras in i den angivna bufferten när man binder med SQLBindCol eller SQLBindParameter.

• Om du inte binder kan du hämta data i chunkar genom att använda SQLGetData och SQLParamData.

Relaterat innehåll

• inbyggda klientfunktioner i SQL Server