Perilaku Driver ODBC Berubah Saat Menangani Konversi Karakter

Driver ODBC Klien Asli SQL Server 2012 (SQLNCLI11.dll) mengubah cara SQL_WCHAR* (NCHAR/NVARCHAR/NVARCHAR(MAX)) dan konversi SQL_CHAR* (CHAR/VARCHAR/NARCHAR(MAX)). Fungsi ODBC, seperti SQLGetData, SQLBindCol, SQLBindParameter, return (-4) SQL_NO_TOTAL sebagai parameter panjang/indikator saat menggunakan driver ODBC SQL Server 2012 Native Client. Versi sebelumnya dari driver ODBC SQL Server Native Client mengembalikan nilai panjang, yang dapat salah.

Perilaku SQLGetData

Banyak fungsi Windows memungkinkan Anda menentukan ukuran buffer 0 dan panjang yang dikembalikan adalah ukuran data yang dikembalikan. Pola berikut umum untuk programmer 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

Namun, SQLGetData tidak boleh digunakan dalam skenario ini. Pola berikut tidak boleh digunakan:

// 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 hanya dapat dipanggil untuk mengambil potongan data aktual. Menggunakan SQLGetData untuk mendapatkan ukuran data tidak didukung.

Berikut ini menunjukkan dampak perubahan driver saat Anda menggunakan pola yang salah. Aplikasi ini mengkueri varchar kolom dan mengikat sebagai Unicode (SQL_UNICODE/SQL_WCHAR):

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

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

Versi Driver ODBC Klien Asli SQL Server	Panjang atau Hasil Indikator	Deskripsi
SQL Server 2008 R2 Native Client atau yang lebih lama	6	Driver salah mengasumsikan bahwa mengonversi CHAR ke WCHAR dapat dicapai dengan panjang * 2.
SQL Server 2012 Native Client (versi 11.0.2100.60) atau yang lebih baru	-4 (SQL_NO_TOTAL)	Driver tidak lagi mengasumsikan bahwa mengonversi dari CHAR ke WCHAR atau WCHAR ke CHAR adalah tindakan (kalikan) 2 atau (bagi)/2. Memanggil SQLGetData* tidak lagi mengembalikan panjang konversi yang diharapkan. Driver mendeteksi konversi ke atau dari CHAR dan WCHAR dan mengembalikan (-4) SQL_NO_TOTAL alih-alih perilaku *2 atau /2 yang bisa salah.

Gunakan SQLGetData untuk mengambil potongan data. (Kode semu ditampilkan:)

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

Perilaku SQLBindCol

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

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

Versi Driver ODBC Klien Asli SQL Server	Panjang atau Hasil Indikator	Deskripsi
SQL Server 2008 R2 Native Client atau yang lebih lama	20	- SQLFetch melaporkan bahwa ada pemotongan di sisi kanan data. - Panjang adalah panjang data yang dikembalikan, bukan apa yang disimpan (mengasumsikan *2 CHAR ke konversi WCHAR yang dapat salah untuk glyph). - Data yang disimpan dalam buffer adalah 123\0. Buffer dijamin null dihentikan.
SQL Server 2012 Native Client (versi 11.0.2100.60) atau yang lebih baru	-4 (SQL_NO_TOTAL)	- SQLFetch melaporkan bahwa ada pemotongan di sisi kanan data. - Panjang menunjukkan -4 (SQL_NO_TOTAL) karena sisa data tidak dikonversi. - Data yang disimpan dalam buffer adalah 123\0. - Buffer dijamin null dihentikan.

SQLBindParameter (Perilaku Parameter OUTPUT)

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

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

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

Versi Driver ODBC Klien Asli SQL Server	Panjang atau Hasil Indikator	Deskripsi
SQL Server 2008 R2 Native Client atau yang lebih lama	2468	- SQLFetch tidak menampilkan lebih banyak data yang tersedia. - SQLMoreResults tidak menampilkan lebih banyak data yang tersedia. - Panjang menunjukkan ukuran data yang dikembalikan dari server, tidak disimpan dalam buffer. - Buffer asli berisi 63 byte dan terminator NULL. Buffer dijamin null dihentikan.
SQL Server 2012 Native Client (versi 11.0.2100.60) atau yang lebih baru	-4 (SQL_NO_TOTAL)	- SQLFetch tidak menampilkan lebih banyak data yang tersedia. - SQLMoreResults tidak menampilkan lebih banyak data yang tersedia. - Panjang menunjukkan (-4) SQL_NO_TOTAL karena sisa data tidak dikonversi. - Buffer asli berisi 63 byte dan terminator NULL. Buffer dijamin null dihentikan.

Melakukan Konversi CHAR dan WCHAR

Driver ODBC Klien Asli SQL Server 2012 menawarkan beberapa cara untuk melakukan konversi CHAR dan WCHAR. Logikanya mirip dengan memanipulasi blob (varchar(max), nvarchar(max), ...):

Data disimpan atau dipotong ke dalam buffer yang ditentukan saat mengikat dengan SQLBindCol atau SQLBindParameter.
Jika Anda tidak mengikat, Anda dapat mengambil data dalam gugus dengan menggunakan SQLGetData dan SQLParamData.

Lihat Juga

Fitur Klien Asli SQL Server

Last updated on 2017-03-06

Bagikan melalui