Share via

SQL Server Native Client Properti Sumber Data (OLE DB)

  • Artikel

Berlaku untuk: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Penting

SNAC SQL Server Native Client (sering disingkat) 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 Driver Microsoft OLE DB (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 yang 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 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 konsumen mengakses 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 penyalinan 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.

Lihat juga

Objek Sumber Data (OLE DB)