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

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics 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 wie SQLGetData, SQLBindCol, SQLBindParameter, return (-4) SQL_NO_TOTAL als Längen-/Indikatorparameter bei Verwendung des SQL Server 2012 Native Client ODBC-Treibers. In früheren Versionen des SQL Server Native Client ODBC-Treibers wurde ein 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 Datenblöcke abzurufen. Die Verwendung von SQLGetData zum Abrufen der Datengröße wird 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 Datenblöcke 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 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-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 verschiedene Möglichkeiten zum Ausführen von CHAR- und WCHAR-Konvertierungen. Die Logik ähnelt dem Bearbeiten von Blobs (varchar(max), nvarchar(max), ...):

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

• Wenn Sie keine Bindung vornehmen, können Sie die Daten in Datenblöcken mithilfe von SQLGetData und SQLParamData abrufen.

Weitere Informationen

SQL Server Native Client-Funktionen