Bagikan melalui


Properti Inisialisasi dan Otorisasi (Penyedia OLE DB Klien Asli)

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 menginterpretasikan properti inisialisasi dan otorisasi OLE DB sebagai berikut:

ID Properti Deskripsi
DBPROP_AUTH_CACHE_AUTHINFO Penyedia SQL Server Native Client OLE DB tidak menyimpan informasi autentikasi cache.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_ENCRYPT_PASSWORD Penyedia SQL Server Native Client OLE DB menggunakan mekanisme keamanan Microsoft SQL Server standar untuk menyembunyikan kata sandi.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_INTEGRATED Jika DBPROP_AUTH_INTEGRATED diatur ke pointer NULL, string null, atau nilai VT_BSTR 'SSPI', penyedia SQL Server Native Client OLE DB menggunakan Mode Autentikasi Windows untuk mengotorisasi akses pengguna ke database SQL Server yang ditentukan oleh properti DBPROP_INIT_DATASOURCE dan DBPROP_INIT_CATALOG.

Jika diatur ke VT_EMPTY (default), keamanan SQL Server digunakan. Login dan kata sandi SQL Server ditentukan di properti DBPROP_AUTH_USERID dan DBPROP_AUTH_PASSWORD.
DBPROP_AUTH_MASK_PASSWORD Penyedia SQL Server Native Client OLE DB menggunakan mekanisme keamanan SQL Server standar untuk menyembunyikan kata sandi.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PASSWORD Kata sandi yang ditetapkan ke login SQL Server. Properti ini digunakan ketika Autentikasi SQL Server dipilih untuk mengotorisasi akses ke database SQL Server.
DBPROP_AUTH_PERSIST_ENCRYPTED Penyedia SQL Server Native Client OLE DB tidak mengenkripsi informasi autentikasi saat dipertahankan.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Penyedia SQL Server Native Client OLE DB mempertahankan nilai autentikasi, termasuk gambar kata sandi, jika diminta untuk melakukannya. Tidak ada enkripsi yang disediakan.
DBPROP_AUTH_USERID Masuk SQL Server. Properti ini digunakan ketika Autentikasi SQL Server dipilih untuk mengotorisasi akses ke database SQL Server.
DBPROP_INIT_ASYNCH Penyedia SQL Server Native Client OLE DB mendukung inisiasi asinkron.

Mengatur bit DBPROPVAL_ASYNCH_INITIALIZE di properti DBPROP_INIT_ASYNCH menyebabkan IDBInitialize::Initialize menjadi panggilan non-pemblokiran. Untuk informasi selengkapnya, lihat Melakukan Operasi Asinkron.
DBPROP_INIT_CATALOG Nama database SQL Server yang sudah ada untuk disambungkan.
DBPROP_INIT_DATASOURCE Nama jaringan server yang menjalankan instans Microsoft SQL Server. Jika ada beberapa instans SQL Server yang berjalan di komputer, untuk menyambungkan ke instans SQL Server tertentu, nilai DBPROP_INIT_DATASOURCE ditentukan sebagai \\ServerName\InstanceName. Urutan escape \\ digunakan untuk garis miring terbalik itu sendiri.
DBPROP_INIT_GENERALTIMEOUT Menunjukkan jumlah detik sebelum permintaan, selain inisialisasi sumber data dan eksekusi perintah, waktu habis. Nilai 0 menunjukkan batas waktu tak terbatas. Penyedia yang bekerja melalui koneksi jaringan atau dalam skenario terdistribusi atau ditransaksikan dapat mendukung properti ini untuk menyarankan komponen yang terdaftar untuk kehabisan waktu jika terjadi permintaan yang berjalan lama. Batas waktu untuk inisialisasi sumber data dan eksekusi perintah tetap diatur oleh DBPROP_INIT_TIMEOUT dan DBPROP_COMMANDTIMEOUT.

DBPROP_INIT_GENERALTIMEOUT bersifat baca-saja, dan jika seseorang mencoba mengaturnya , kesalahan dwstatus DBPROPSTATUS_NOTSETTABLE dikembalikan.
DBPROP_INIT_HWND Handel Windows dari aplikasi panggilan. Handel jendela yang valid diperlukan untuk kotak dialog inisialisasi yang ditampilkan saat meminta properti inisialisasi diizinkan.
DBPROP_INIT_IMPERSONATION_LEVEL Penyedia SQL Server Native Client OLE DB tidak mendukung penyesuaian tingkat peniruan identitas.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_LCID Penyedia SQL Server Native Client OLE DB memvalidasi ID lokal dan mengembalikan kesalahan jika ID lokal tidak didukung atau tidak diinstal pada klien.
DBPROP_INIT_LOCATION Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_MODE Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROMPT Penyedia SQL Server Native Client OLE DB mendukung semua mode permintaan untuk inisialisasi sumber data. Penyedia SQL Server Native Client OLE DB menggunakan DBPROMPT_NOPROMPT sebagai pengaturan default untuk properti .
DBPROP_INIT_PROTECTION_LEVEL Penyedia SQL Server Native Client OLE DB tidak mendukung tingkat perlindungan pada koneksi ke instans SQL Server.

Penyedia SQL Server Native Client OLE DB mengembalikan DB_S_ERRORSOCCURRED pada upaya untuk mengatur nilai properti. Anggota dwStatus dari Struktur DBPROP menunjukkan DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROVIDERSTRING Lihat string penyedia SQL Server Native Client OLE DB nanti dalam topik ini.
DBPROP_INIT_TIMEOUT Penyedia SQL Server Native Client OLE DB mengembalikan kesalahan pada inisialisasi jika koneksi ke instans SQL Server tidak dapat dibuat dalam jumlah detik yang ditentukan.

Dalam properti khusus penyedia yang ditetapkan DBPROPSET_SQLSERVERDBINIT, penyedia SQL Server Native Client OLE DB menentukan properti inisialisasi tambahan ini.

ID Properti Deskripsi
SSPROP_AUTH_OLD_PASSWORD Jenis: VT_BSTR

R/W: Tulis

Default: VT_EMPTY

Deskripsi: Kata sandi saat ini atau yang kedaluwarsa. Untuk informasi selengkapnya, lihat Mengubah Kata Sandi Secara Terprogram.
SSPROP_INIT_APPNAME Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Nama aplikasi klien.
SSPROP_INIT_AUTOTRANSLATE Jenis: VT_BOOL

R/W: Baca/tulis

Default: VARIANT_TRUE

Deskripsi: Konversi karakter OEM/ANSI.

VARIANT_TRUE: Penyedia SQL Server Native Client OLE DB menerjemahkan string karakter ANSI yang dikirim antara klien dan server dengan mengonversi melalui Unicode untuk meminimalkan masalah dalam mencocokkan karakter yang diperluas antara halaman kode pada klien dan server:

Klien DBTYPE_STR data yang dikirim ke instans karakter SQL Server, varchar, atau variabel teks, parameter, atau kolom dikonversi dari karakter ke Unicode menggunakan halaman kode ANSI klien (ACP) lalu dikonversi dari Unicode ke karakter menggunakan ACP server.

Data karakter, varchar, atau teks SQL Server yang dikirim ke variabel DBTYPE_STR klien dikonversi dari karakter ke Unicode menggunakan ACP server lalu dikonversi dari Unicode ke karakter menggunakan ACP klien.

Konversi ini dilakukan pada klien oleh penyedia SQL Server Native Client OLE DB. Ini mengharuskan ACP yang sama yang digunakan pada server tersedia di klien.

Pengaturan ini tidak berpengaruh pada konversi yang terjadi untuk transfer ini:

Unicode DBTYPE_WSTR data klien yang dikirim ke karakter, varchar, atau teks di server.

data server char, varchar, atau teks yang dikirim ke variabel unicode DBTYPE_WSTR pada klien.

ANSI DBTYPE_STR data klien yang dikirim ke Unicode nchar, nvarchar, atau ntext di server.

Char Unicode, varchar, atau data server teks yang dikirim ke variabel ansi DBTYPE_STR pada klien.

VARIANT_FALSE: Penyedia SQL Server Native Client OLE DB tidak melakukan terjemahan karakter.

Penyedia SQL Server Native Client OLE DB tidak menerjemahkan karakter ANSI klien DBTYPE_STR data yang dikirim ke variabel karakter, varchar, atau teks , parameter, atau kolom di server. Tidak ada terjemahan yang dilakukan pada data karakter, varchar, atau teks yang dikirim dari server ke variabel DBTYPE_STR pada klien.

Jika klien dan instans SQL Server menggunakan ACL yang berbeda, karakter yang diperluas dapat disalahartikan.
SSPROP_INIT_CURRENTLANGUAGE Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Nama bahasa SQL Server. Mengidentifikasi bahasa yang digunakan untuk pemilihan dan pemformatan pesan sistem. Bahasa harus diinstal pada komputer yang menjalankan instans SQL Server atau inisialisasi sumber data gagal.
SSPROP_INIT_DATATYPECOMPATIBILITY Jenis: VT_UI2

R/W: Baca/tulis

Default: 0

Deskripsi: Memungkinkan kompatibilitas jenis data antara aplikasi SQL Server dan ActiveX Data Object (ADO). Jika nilai default 0 digunakan, jenis data menangani default ke yang digunakan oleh penyedia. Jika nilai 80 digunakan, penanganan jenis data hanya menggunakan jenis data SQL Server 2000 (8.x). Untuk informasi selengkapnya, lihat Menggunakan ADO dengan SQL Server Native Client.
SSPROP_INIT_ENCRYPT Jenis: VT_BOOL

R/W: Baca/Tulis

Default: VARIANT_FALSE

Deskripsi: Untuk mengenkripsi data yang melalui jaringan, properti SSPROP_INIT_ENCRYPT diatur ke VARIANT_TRUE.

Jika Aktifkan Enkripsi Protokol aktif, enkripsi akan selalu terjadi, terlepas dari pengaturan SSPROP_INIT_ENCRYPT. Jika tidak aktif dan SSPROP_INIT_ENCRYPT diatur ke VARIANT_TRUE, maka enkripsi akan terjadi.

Jika Aktifkan Enkripsi Protokol nonaktif dan SSPROP_INIT_ENCRYPT diatur ke VARIANT_FALSE, maka tidak ada enkripsi yang terjadi.
SSPROP_INIT_FAILOVERPARTNER Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Menentukan nama mitra failover untuk pencerminan database. Ini adalah properti inisialisasi dan hanya dapat diatur sebelum inisialisasi. Setelah inisialisasi, ini akan mengembalikan mitra failover, jika ada, yang dikembalikan oleh server utama.

Ini memungkinkan aplikasi pintar untuk menyimpan server cadangan yang terakhir ditentukan, tetapi aplikasi tersebut harus mengetahui bahwa informasi hanya diperbarui ketika koneksi pertama kali dibuat (atau reset, jika dikumpulkan) dan dapat menjadi kedaluarsa untuk koneksi jangka panjang.

Setelah membuat koneksi, aplikasi dapat mengkueri atribut ini untuk menentukan identitas mitra failover. Jika server utama tidak memiliki mitra failover, properti ini akan mengembalikan string kosong. Untuk informasi selengkapnya, lihat Menggunakan Pencerminan Database.
SSPROP_INIT_FILENAME Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Menentukan nama file utama database yang dapat dilampirkan. Database ini dilampirkan dan menjadi database default untuk koneksi. Untuk menggunakan SSPROP_INIT_FILENAME, Anda harus menentukan nama database sebagai nilai properti inisialisasi DBPROP_INIT_CATALOG. Jika nama database tidak ada, maka nama file utama yang ditentukan dalam SSPROP_INIT_FILENAME dan melampirkan database tersebut dengan nama yang ditentukan dalam DBPROP_INIT_CATALOG. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali.
SSPROP_INIT_MARSCONNECTION Jenis: VT_BOOL

R/W: Baca/tulis

Default: VARIANT_FALSE

Deskripsi: Menentukan apakah Beberapa Set Hasil Aktif (MARS) diaktifkan untuk koneksi. Opsi ini harus diatur ke true sebelum koneksi dibuat ke database. Untuk informasi selengkapnya, lihat Menggunakan Beberapa Kumpulan Hasil Aktif (MARS).
SSPROP_INIT_NETWORKADDRESS Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Alamat jaringan server yang menjalankan instans SQL Server yang ditentukan oleh properti DBPROP_INIT_DATASOURCE.
SSPROP_INIT_NETWORKLIBRARY Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: Nama networklibrary (DLL) yang digunakan untuk berkomunikasi dengan instans SQL Server. Nama tidak boleh menyertakan jalur atau ekstensi nama file .dll.

Default dapat disesuaikan menggunakan Utilitas Konfigurasi Klien SQL Server.

Catatan: Hanya TCP dan Pipa Bernama yang didukung oleh properti ini. Jika Anda menggunakan properti ini dengan awalan, Anda berakhir dengan awalan ganda yang menghasilkan kesalahan, karena properti digunakan untuk menghasilkan awalan secara internal.
SSPROP_INIT_PACKETSIZE Jenis: VT_I4

R/W: Baca/tulis

Deskripsi: Ukuran paket jaringan dalam byte. Nilai properti ukuran paket harus antara 512 dan 32.767. Ukuran paket jaringan penyedia SQL Server Native Client OLE DB default adalah 4.096.
SSPROP_INIT_TAGCOLUMNCOLLATION Jenis: BOOL

R/W: Tulis

Default: FALSE

Deskripsi: Digunakan selama pembaruan database saat kursor sisi server digunakan. Properti ini menandai data dengan informasi kolase yang diperoleh dari server alih-alih halaman kode pada klien. Saat ini, properti ini hanya digunakan oleh proses kueri terdistribusi karena mengetahui kolase data tujuan dan mengonversinya dengan benar.
SSPROP_INIT_TRUST_SERVER_CERTIFICATE Jenis: VT_BOOL

R/W: Baca/tulis

Default: VARIANT_FALSE

Deskripsi: Digunakan untuk mengaktifkan atau menonaktifkan validasi sertifikat server. Properti ini bersifat baca/tulis, tetapi mencoba mengaturnya setelah koneksi dibuat akan mengakibatkan kesalahan.

Properti ini diabaikan jika klien dikonfigurasi untuk memerlukan validasi sertifikat. Namun, aplikasi dapat menggunakannya bersama dengan SSPROP_INIT_ENCRYPT untuk menjamin bahwa koneksinya ke server dienkripsi, bahkan jika klien dikonfigurasi untuk tidak memerlukan enkripsi dan tidak ada sertifikat yang disediakan pada klien.

Aplikasi klien dapat mengkueri properti ini setelah koneksi dibuka untuk menentukan pengaturan enkripsi dan validasi aktual yang digunakan.

Catatan: Menggunakan enkripsi tanpa validasi sertifikat memberikan perlindungan parsial terhadap sniffing paket, tetapi tidak melindungi dari serangan man-in-the-middle. Ini hanya memungkinkan untuk mengenkripsi login dan data yang dikirim ke server tanpa memvalidasi sertifikat server.

Untuk informasi selengkapnya, lihat Menggunakan Enkripsi Tanpa Validasi.
SSPROP_INIT_USEPROCFORPREP Jenis: VT_I4

R/W: Baca/tulis

Default: SSPROPVAL_USEPROCFORPREP_ON

Deskripsi: Penggunaan prosedur tersimpan SQL Server. Menentukan penggunaan prosedur tersimpan sementara SQL Server untuk mendukung antarmuka ICommandPrepare . Properti ini bermakna hanya ketika menyambungkan ke SQL Server 6.5. Properti diabaikan untuk versi yang lebih baru.

SSPROPVAL_USEPROCFORPREP_OFF: Prosedur tersimpan sementara tidak dibuat saat perintah disiapkan.

SSPROPVAL_USEPROCFORPREP_ON: Prosedur tersimpan sementara dibuat saat perintah disiapkan. Prosedur tersimpan sementara dihilangkan saat sesi dirilis.

SSPROPVAL_USEPROCFORPREP_ON_DROP: Prosedur tersimpan sementara dibuat saat perintah disiapkan. Prosedur dihilangkan ketika perintah tidak siap dengan ICommandPrepare::Unprepare, ketika perintah baru ditentukan untuk objek perintah dengan ICommandText::SetCommandText, atau ketika semua referensi aplikasi ke perintah dirilis.
SSPROP_INIT_WSID Jenis: VT_BSTR

R/W: Baca/tulis

Deskripsi: String yang mengidentifikasi stasiun kerja.

Dalam properti khusus penyedia yang ditetapkan DBPROPSET_SQLSERVERDATASOURCEINFO, penyedia SQL Server Native Client OLE DB menentukan properti tambahan; lihat Properti Informasi Sumber Data untuk informasi selengkapnya.

String Penyedia OLE DB Klien Asli SQL Server

Penyedia SQL Server Native Client OLE DB mengenali sintaks seperti ODBC dalam nilai properti string penyedia. Properti string penyedia disediakan sebagai nilai properti inisialisasi OLE DB DBPROP_INIT_PROVIDERSTRING ketika koneksi dibuat ke sumber data OLE DB. Properti ini menentukan data koneksi khusus penyedia OLE DB yang diperlukan untuk menerapkan koneksi ke sumber data OLE DB. Dalam string, elemen dibatasi dengan menggunakan titik koma. Elemen akhir dalam string harus dihentikan dengan titik koma. Setiap elemen terdiri dari kata kunci, karakter tanda sama dengan, dan nilai yang diteruskan pada inisialisasi. Contohnya:

Server=MyServer;UID=MyUserName;  

Dengan penyedia SQL Server Native Client OLE DB, konsumen tidak perlu menggunakan properti string penyedia. Konsumen dapat mengatur properti inisialisasi apa pun yang tercermin dalam string penyedia dengan menggunakan properti inisialisasi khusus penyedia OLE DB atau SQL Server Native Client OLE DB.

Untuk daftar kata kunci yang tersedia di penyedia SQL Server Native Client OLE DB, lihat Menggunakan Kata Kunci String Koneksi dengan Klien Asli SQL Server.

Lihat Juga

Objek Sumber Data (OLE DB)