Zmiana zachowania sterownika ODBC podczas obsługi konwersji znaków

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Sterownik ODBC z natywnego klienta z SQL Server 2012 (11.x) (SQLNCLI11.dll) zmienił sposób realizacji konwersji SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) i SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)). Funkcje ODBC, takie jak SQLGetData, SQLBindCol, SQLBindParameter, return (-4) SQL_NO_TOTAL jako parametr długości/wskaźnika podczas korzystania z sterownika ODBC Native Client SQL Server 2012. Poprzednie wersje sterownika ODBC dla natywnego klienta SQL Server zwracały wartość długości, która może być nieprawidłowa.

Zachowanie SQLGetData

Wiele funkcji Windows pozwala określić rozmiar bufora 0, a zwrócona długość to rozmiar zwróconych danych. Następujący wzorzec jest powszechny wśród programistów 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  

Jednak SQLGetData nie powinno być używane w tym scenariuszu. Nie powinno się stosować następującego wzoru:

// 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 można wywołać tylko w celu pobrania fragmentów rzeczywistych danych. Używanie SQLGetData do określania rozmiaru danych nie jest nieobsługiwane.

Poniżej przedstawiono wpływ zmiany sterownika przy użyciu nieprawidłowego wzoru. Ta aplikacja zapytuje kolumnę varchar i powiązanie jako Unicode (SQL_UNICODE/SQL_WCHAR):

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

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

Użyj SQLGetData do pobrania fragmentów danych. (Pokazano pseudokod:)

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

Zachowanie SQLBindCol

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

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

SQLBindParameter (Zachowanie parametrów wyjściowych)

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

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

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

Przeprowadzanie konwersji CHAR i WCHAR

Natywny sterownik ODBC klienta SQL Server 2012 (11.x) oferuje kilka sposobów wykonywania konwersji CHAR i WCHAR. Logika jest podobna do manipulowania plamami (varchar(max), nvarchar(max), ...):

• Dane są zapisywane lub obcinane do określonego bufora podczas wiązania z SQLBindCol lub SQLBindParametrem.

• Jeśli nie masz bindu, możesz pobierać dane w kawałkach, używając SQLGetData i SQLParamData.

Treści powiązane

• funkcji klienta natywnego programu SQL Server