Properti Sumber Data Klien Asli SQL Server (OLE DB)
Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Penting
SQL Server Native Client (sering disingkat SNAC) telah dihapus dari SQL Server 2022 (16.x) dan SQL Server Management Studio 19 (SSMS). Penyedia SQL Server Native Client OLE DB (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan baru. Beralih ke Microsoft OLE DB Driver (MSOLEDBSQL) baru untuk SQL Server ke depannya.
Penyedia SQL Server Native Client OLE DB mengimplementasikan properti sumber data sebagai berikut.
ID Properti | Deskripsi |
---|---|
DBPROP_CURRENTCATALOG | R/W: Baca/tulis Default: Tidak Ada Deskripsi: Nilai DBPROP_CURRENTCATALOG melaporkan database saat ini untuk sesi penyedia SQL Server Native Client OLE DB. Mengatur nilai properti memiliki efek identik sebagai mengatur database saat ini dengan menggunakan pernyataan database TRANSACT-SQL USE. Dimulai dengan SQL Server 2005 (9.x), jika Anda memanggil sp_defaultdb dan menentukan nama database dalam huruf kecil, bahkan jika database awalnya dibuat dengan nama kasus campuran, DBPROP_CURRENTCATALOG akan mengembalikan nama dalam huruf kecil. Dengan versi SQL Server sebelumnya, DBPROP_CURRENTCATALOG akan mengembalikan kasus campuran yang diharapkan. |
DBPROP_MULTIPLECONNECTIONS | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Jika koneksi menjalankan perintah yang tidak menghasilkan set baris atau menghasilkan set baris yang bukan kursor server dan Anda menjalankan perintah lain, koneksi baru akan dibuat untuk menjalankan perintah baru jika DBPROP_MULTIPLECONNECTIONS VARIANT_TRUE. Penyedia SQL Server Native Client OLE DB tidak akan membuat koneksi lain jika DBPROP_MULTIPLECONNECTION VARIANT_FALSE atau jika transaksi aktif pada koneksi. Penyedia SQL Server Native Client OLE DB mengembalikan DB_E_OBJECTOPEN jika DBPROP_MULTIPLECONNECTIONS VARIANT_FALSE dan mengembalikan E_FAIL jika ada transaksi aktif. Transaksi dan penguncian dikelola oleh SQL Server berdasarkan per koneksi. Jika koneksi kedua dibuat, perintah pada koneksi terpisah tidak berbagi kunci. Untuk memastikan bahwa satu perintah tidak memblokir perintah lain, tahan kunci pada baris yang diminta oleh perintah lainnya. Ini juga berlaku saat membuat beberapa sesi. Setiap sesi memiliki koneksi terpisah. |
Dalam kumpulan properti khusus penyedia DBPROPSET_SQLSERVERDATASOURCE, penyedia SQL Server Native Client OLE DB menentukan properti sumber data tambahan berikut.
ID Properti | Deskripsi |
---|---|
SSPROP_ENABLEFASTLOAD | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Untuk mengaktifkan salinan massal dari memori, properti SSPROP_ENABLEFASTLOAD harus diatur ke VARIANT_TRUE. Dengan properti ini diatur pada sumber data, sesi yang baru dibuat memungkinkan akses konsumen ke antarmuka IRowsetFastLoad . Jika properti diatur ke VARIANT_TRUE, antarmuka IRowsetFastLoad tersedia melalui IOpenRowset::OpenRowset dengan meminta antarmuka IID_IRowsetFastLoad atau dengan mengatur SSPROP_IRowsetFastLoad ke VARIANT_TRUE. |
SSPROP_ENABLEBULKCOPY | R/W: Baca/tulis Default: VARIANT_FALSE Deskripsi: Untuk mengaktifkan salinan massal dari file, properti SSPROP_ENABLEBULKCOPY harus diatur ke VARIANT_TRUE. Dengan properti ini diatur pada sumber data, akses konsumen ke antarmuka IBCPSession tersedia di bawah tingkat yang sama dengan Sesi. SSPROP_IRowsetFastLoad juga harus diatur ke VARIANT_TRUE. |