Verhaltensänderungen des ODBC-Treibers bei der Behandlung von Zeichenkonvertierungen

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Der SQL Server 2012 (11.x) Native Client ODBC-Treiber (SQLNCLI11.dll) hat die Funktionsweise der Konvertierungen SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) und SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)) geändert. ODBC-Funktionen, z. B. SQLGetData, SQLBindCol, SQLBindParameter, geben (-4 SQL_NO_TOTAL) als Längen-/Indikatorparameter zurück, wenn sie den ODBC-Treiber SQL Server 2012 Native Client verwenden. Frühere Versionen des SQL Server Native Client ODBC-Treibers haben einen Längenwert zurückgegeben, der falsch sein kann.

SQLGetData-Verhalten

Bei vielen Windows-Funktionen können Sie die Puffergröße 0 angeben, wobei die zurückgegebene Länge der Größe der zurückgegebenen Daten entspricht. Windows-Programmierer verwenden häufig das folgende Muster:

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 sollte in diesem Szenario jedoch nicht verwendet werden. Das folgende Muster sollte nicht verwendet werden:

// 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 kann nur aufgerufen werden, um Blöcke der tatsächlichen Daten abzurufen. Die Verwendung von SQLGetData zum Abrufen der Datengröße wird nicht nicht unterstützt.

Im Folgenden wird veranschaulicht, wie sich der Treiberwechsel bei Verwendung des falschen Musters auswirkt. Diese Anwendung fragt eine varchar-Spalte und -Bindung als Unicode ab (SQL_UNICODE/SQL_WCHAR):

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

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

Verwenden Sie SQLGetData , um die Blöcke der Daten abzurufen. (Dargestellter Pseudocode:)

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

SQLBindCol-Verhalten

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

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

SQLBindParameter (Verhalten des OUTPUT-Parameters)

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

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

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

Ausführen von CHAR- und WCHAR-Konvertierungen

Der SQL Server 2012 (11.x) Native Client ODBC-Treiber bietet mehrere Möglichkeiten, CHAR- und WCHAR-Konvertierungen durchzuführen. Die Logik ähnelt der Bearbeitung von Blobs (varchar(max), nvarchar(max), ...):

• Daten werden beim Binden mit SQLBindCol oder SQLBindParameter im angegebenen Puffer gespeichert oder abgeschnitten.

• Wenn Sie keine Bindung durchführen, können Sie die Daten mit SQLGetData und SQLParamData in Blöcken abrufen.

Weitere Informationen

SQL Server Native Client-Funktionen