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

SQL Server 2012 Native Client ODBC Driver （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 Driver 版本	長度或指標結果	說明
SQL Server 2008 R2 Native Client 或更早版本	6	驅動程式錯誤地假設將 CHAR 轉換成 WCHAR 可以完成長度 * 2。
SQL Server 2012 Native Client （版本 11.0.2100.60）或更新版本	-4 （SQL_NO_TOTAL）	驅動程式不再假設從 CHAR 轉換為 WCHAR 或 WCHAR 轉換為 CHAR 是 2 或（divide）/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 Driver 版本	長度或指標結果	說明
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 Driver 版本	長度或指標結果	說明
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 功能

Last updated on 2017-03-06

共用方式為