Properti Inisialisasi dan Otorisasi (Penyedia OLE DB Klien Asli)
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 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 SQL Server Microsoft 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 penunjuk 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 dalam 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 | SQL Server masuk. 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 tertentu SQL Server nilai DBPROP_INIT_DATASOURCE ditentukan sebagai \\ServerName\InstanceName. Urutan escape \\ digunakan untuk garis miring terbelakang 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 bertransaksi dapat mendukung properti ini untuk menyarankan komponen yang terdaftar untuk kehabisan waktu jika terjadi permintaan yang berjalan lama. Waktu habis 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 diatur 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 SQL Server char, 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. SQL Server data karakter, varchar, atau teks 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 DBTYPE_WSTR Unicode pada klien. ANSI DBTYPE_STR data klien yang dikirim ke Unicode nchar, nvarchar, atau ntext di server. Unicode char, varchar, atau data server teks yang dikirim ke variabel DBTYPE_STR ANSI 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 yang 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 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 nonaktif 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 menyadari bahwa informasi hanya diperbarui ketika koneksi pertama kali dibuat (atau direset, jika dikumpulkan) dan dapat kedaluarsa untuk koneksi jangka panjang. Setelah membuat koneksi, aplikasi dapat meminta 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 Kumpulan 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 SQL Server prosedur tersimpan sementara untuk mendukung antarmuka ICommandPrepare. Properti ini hanya bermakna saat 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 kumpulan properti khusus penyedia DBPROPSET_SQLSERVERDATASOURCEINFO, penyedia SQL Server Native Client OLE DB menentukan properti tambahan; lihat Properti Informasi Sumber Data untuk informasi selengkapnya.
String Penyedia SQL Server Native Client OLE DB
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 mengimplementasikan 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 SQL Server Native Client.
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk