ODBC 驅動程式在處理字元轉換上的行為變更

  • 發行項

SQL Server 2012 Native Client ODBC 驅動程式 (SQLNCLI11.dll) 改變了其處理 SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) 和 SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)) 轉換的方式。 當使用 SQL Server 2012 Native Client ODBC 驅動程式時，ODBC 函數如 SQLGetData、SQLBindCol、SQLBindParameter 等傳回的長度/指標參數將會是 (-4) SQL_NO_TOTAL。 舊版的 SQL Server Native Client ODBC 驅動程式以往傳回長度值，而這可能不正確。

SQLGetData 行為

許多 Windows 函數都可讓您指定緩衝區大小為 0，且傳回的長度會是所傳回資料的大小。 以下的寫法對 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

然而，在此情況下不該使用 SQLGetData。 請勿使用這種寫法：

// 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 只適用於擷取實際資料區塊。 現已不支援使用 SQLGetData 取得資料的大小。

以下說明當您使用不正確的寫法時，驅動程式變更所造成的影響。 此應用程式將查詢 varchar 資料行並以 Unicode (SQL_UNICODE/SQL_WCHAR) 的形式進行繫結：

查詢：select convert(varchar(36), '123')

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

SQL Server Native Client ODBC 驅動程式版本

長度或指標結果

描述

SQL Server 2008 R2 Native Client 或更早版本

6

驅動程式誤認為只要長度 * 2 即可將 CHAR 轉換成 WCHAR。

SQL Server 2012 Native Client (11.0.2100.60 版) 或更新版本

-4 (SQL_NO_TOTAL)

驅動程式不再認為從 CHAR 轉換成 WCHAR 或從 WCHAR 轉換成 CHAR 是單純的 *2 (乘法) 或 /2 (除法) 運算動作。

呼叫 SQLGetData 不會再傳回預期轉換後的長度。 驅動程式將偵測出這是 CHAR 與 WCHAR 之間的相互轉換，並且傳回 (-4) SQL_NO_TOTAL 而不至於會有 *2 或 /2 的錯誤行為。

請使用 SQLGetData 擷取資料區塊。 (虛擬程式碼如下所示)

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 行為

查詢： select convert(varchar(36), '1234567890')

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

SQL Server Native Client ODBC 驅動程式版本

長度或指標結果

描述

SQL Server 2008 R2 Native Client 或更早版本

20

  • SQLFetch 會回報資料的右側出現截斷情況。

  • 長度將是所傳回資料的長度，而非任何儲存的內容 (假象誤認為 *2 CHAR 可轉換成 WCHAR)。

  • 儲存在緩衝區內的資料是 123\0。 緩衝區一定是以 NULL 結尾。

SQL Server 2012 Native Client (11.0.2100.60 版) 或更新版本

-4 (SQL_NO_TOTAL)

  • SQLFetch 會回報資料的右側出現截斷情況。

  • 由於資料的其餘部分並未轉換，指出的長度為 -4 (SQL_NO_TOTAL)。

  • 儲存在緩衝區內的資料是 123\0。 - 緩衝區一定是以 NULL 結尾。

SQLBindParameter (OUTPUT 參數行為)

查詢： create procedure spTest @p1 varchar(max) OUTPUT

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

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

SQL Server Native Client ODBC 驅動程式版本

長度或指標結果

描述

SQL Server 2008 R2 Native Client 或更早版本

2468

  • SQLFetch 傳回沒有其他可用的資料。

  • SQLMoreResults 傳回沒有其他可用的資料。

  • 指出的長度是從伺服器傳回之資料的大小，而非緩衝區內所儲存資料的大小。

  • 原始緩衝區內包含 63 個位元組和 NULL 結束字元。 緩衝區一定是以 NULL 結尾。

SQL Server 2012 Native Client (11.0.2100.60 版) 或更新版本

-4 (SQL_NO_TOTAL)

  • SQLFetch 傳回沒有其他可用的資料。

  • SQLMoreResults 傳回沒有其他可用的資料。

  • 由於資料的其餘部分並未轉換，指出的長度為 (-4) SQL_NO_TOTAL。

  • 原始緩衝區內包含 63 個位元組和 NULL 結束字元。 緩衝區一定是以 NULL 結尾。

執行 CHAR 和 WCHAR 轉換

SQL Server 2012 Native Client ODBC 驅動程式提供了幾種方法來執行 CHAR 和 WCHAR 轉換。 其邏輯類似於操作 BLOB (varchar(max)、nvarchar(max) 等)：

  • 透過 SQLBindCol 或 SQLBindParameter 進行繫結時，資料會儲存或截斷至指定的緩衝區。

  • 如果沒有繫結，便可使用 SQLGetData 和 SQLParamData 以區塊形式擷取資料。

請參閱

其他資源

SQL Server Native Client 功能