Menggunakan Kata Kunci String Koneksi dengan Driver OLE DB untuk SQL Server
Berlaku untuk: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Beberapa API di Driver OLE DB untuk SQL Server menggunakan string koneksi untuk menentukan atribut koneksi. String koneksi adalah daftar kata kunci dan nilai terkait; setiap kata kunci mengidentifikasi atribut koneksi tertentu.
Catatan
Driver OLE DB untuk SQL Server memungkinkan ambiguitas dalam string koneksi untuk mempertahankan kompatibilitas mundur (misalnya, beberapa kata kunci dapat ditentukan lebih dari sekali, dan kata kunci yang bertentangan dapat diizinkan dengan resolusi berdasarkan posisi atau prioritas). Rilis Driver OLE DB di masa mendatang untuk SQL Server mungkin tidak mengizinkan ambiguitas dalam string koneksi. ini adalah praktik yang baik saat memodifikasi aplikasi untuk menggunakan Driver OLE DB untuk SQL Server untuk menghilangkan dependensi apa pun pada ambiguitas string koneksi.
Bagian berikut menjelaskan kata kunci yang dapat digunakan dengan Driver OLE DB untuk SQL Server, dan Objek Data ActiveX (ADO) saat menggunakan Driver OLE DB untuk SQL Server sebagai penyedia data.
Kata kunci string koneksi Driver OLE DB
Ada dua cara aplikasi OLE DB dapat menginisialisasi objek sumber data:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
Dalam kasus pertama, string penyedia dapat digunakan untuk menginisialisasi properti koneksi dengan mengatur properti DBPROP_INIT_PROVIDERSTRING dalam kumpulan properti DBPROPSET_DBINIT. Dalam kasus kedua, string inisialisasi dapat diteruskan ke metode IDataInitialize::GetDataSource untuk menginisialisasi properti koneksi. Kedua metode menginisialisasi properti koneksi OLE DB yang sama, tetapi kumpulan kata kunci yang berbeda digunakan. Kumpulan kata kunci yang digunakan oleh IDataInitialize::GetDataSource adalah minimal deskripsi properti dalam grup properti inisialisasi.
Setiap pengaturan string penyedia yang memiliki properti OLE DB yang sesuai diatur ke beberapa nilai default atau secara eksplisit diatur ke nilai, nilai properti OLE DB akan mengambil alih pengaturan dalam string penyedia.
Properti Boolean yang diatur dalam string penyedia melalui nilai DBPROP_INIT_PROVIDERSTRING diatur menggunakan nilai yes dan no. Properti Boolean yang diatur dalam string inisialisasi menggunakan IDataInitialize::GetDataSource diatur menggunakan nilai true dan false.
Aplikasi yang menggunakan IDataInitialize::GetDataSource juga dapat menggunakan kata kunci yang digunakan oleh IDBInitialize::Initialize, tetapi hanya untuk properti yang tidak memiliki nilai default. Jika aplikasi menggunakan kata kunci IDataInitialize::GetDataSource dan kata kunci IDBInitialize::Initialize dalam string inisialisasi, pengaturan kata kunci IDataInitialize::GetDataSource digunakan. Disarankan agar aplikasi tidak menggunakan IDBInitialize::Initialize kata kunci di IDataInitialize:GetDataSource string koneksi s, karena perilaku ini mungkin tidak dipertahankan dalam rilis mendatang.
Catatan
String koneksi melewati IDataInitialize::GetDataSource dikonversi menjadi properti dan diterapkan melalui IDBProperties::SetProperties. Jika layanan komponen menemukan deskripsi properti di IDBProperties::GetPropertyInfo, properti ini akan diterapkan sebagai properti yang berdiri sendiri. Jika tidak, itu akan diterapkan melalui properti DBPROP_PROVIDERSTRING. Misalnya, jika Anda menentukan string koneksi Sumber Data=server1; Server=server2, Sumber Data akan diatur sebagai properti, tetapi Server akan masuk ke string penyedia.
Jika Anda menentukan beberapa instans properti khusus penyedia yang sama, nilai pertama properti pertama akan digunakan.
Menggunakan IDBInitialize::Initialize
String koneksi yang digunakan oleh aplikasi OLE DB menggunakan DBPROP_INIT_PROVIDERSTRING dengan IDBInitialize::Initialize memiliki sintaks berikut:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Nilai atribut secara opsional dapat diapit kurung kurawal, dan praktik yang baik untuk melakukannya. Praktik ini menghindari masalah ketika nilai atribut berisi karakter non-alfanumerik. Kurung kurawal penutup pertama dalam nilai diasumsikan untuk mengakhiri nilai, sehingga nilai tidak boleh berisi karakter kurung kurawal penutup.
Karakter spasi setelah = tanda kata kunci string koneksi akan ditafsirkan sebagai harfiah, bahkan jika nilai diapit dalam tanda kutip.
Tabel berikut ini menjelaskan kata kunci yang dapat digunakan dengan DBPROP_INIT_PROVIDERSTRING.
| Kata kunci | Properti inisialisasi | Deskripsi |
|---|---|---|
| Addr | SSPROP_INIT_NETWORKADDRESS | Sinonim untuk Alamat. |
| Alamat | SSPROP_INIT_NETWORKADDRESS | Alamat jaringan server yang menjalankan instans SQL Server. Alamat biasanya merupakan nama jaringan server, tetapi dapat berupa nama lain seperti pipa, alamat IP, atau port TCP/IP dan alamat soket. Jika Anda menentukan alamat IP, pastikan bahwa protokol TCP/IP atau pipa bernama diaktifkan di Pengelola Konfigurasi SQL Server. Nilai Alamat lebih diutamakan daripada nilai yang diteruskan ke Server dalam string koneksi saat menggunakan Driver OLE DB untuk SQL Server. Perhatikan juga bahwa Address=; akan terhubung ke server yang ditentukan dalam kata kunci Server , sedangkan Address= ;, Address=.;, , Address=localhost;dan Address=(local); semua menyebabkan koneksi ke server lokal.Sintaks lengkap untuk kata kunci Alamat adalah sebagai berikut: [protocol:]Address[,port |\pipe\pipename] protokol dapat berupa tcp (TCP/IP), lpc (memori bersama), atau np (pipa bernama). Untuk informasi selengkapnya tentang protokol, lihat Mengonfigurasi Protokol Klien. Jika tidak ada protokol atau kata kunci Jaringan yang ditentukan, Driver OLE DB untuk SQL Server tidak akan menggunakan urutan protokol yang ditentukan dalam Pengelola Konfigurasi SQL Server. port adalah port yang akan disambungkan, pada server yang ditentukan. Secara default, SQL Server menggunakan port 1433. |
| APP | SSPROP_INIT_APPNAME | String yang mengidentifikasi aplikasi. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite.Default adalah ReadWrite. Untuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Nama file utama (sertakan nama jalur lengkap) dari database yang dapat dilampirkan. Untuk menggunakan AttachDBFileName, Anda juga harus menentukan nama database dengan kata kunci Database string penyedia. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali (database tersebut menggunakan database terlampir sebagai default untuk koneksi). |
| Autentikasi1 | SSPROP_AUTH_MODE | Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah:
CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan Integrated Security kata kunci autentikasi (atau Trusted_Connection) . Disarankan agar aplikasi yang menggunakan Integrated Security (atau Trusted_Connection) kata kunci atau properti terkaitnya menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk ActiveDirectoryIntegrated mengaktifkan perilaku enkripsi dan validasi sertifikat baru.CATATAN: Disarankan agar aplikasi yang menggunakan SQL Server autentikasi mengatur nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku enkripsi dan validasi sertifikat baru. |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Sinonim untuk AutoTranslate. |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah yes dan no. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | Mengontrol jumlah upaya koneksi ulang jika koneksi hilang. Nilai yang valid berkisar dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk menyambungkan kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Nilai yang valid berkisar dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| Database | DBPROP_INIT_CATALOG | Nama database. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Menentukan mode penanganan jenis data yang akan digunakan. Nilai yang dikenali adalah 0 untuk jenis data penyedia dan 80 untuk jenis data SQL Server 2000. |
| Enkripsi1 | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang memungkinkan adalah Optional, Mandatory, dan Strict. Nilai defaultnya adalah Mandatory. Untuk versi 18.x.x, lihat Perbedaan versi utama MSOLEDBSQL. |
| FailoverPartner | SSPROP_INIT_FAILOVERPARTNER | Nama server failover yang digunakan untuk pencerminan database. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | SPN untuk mitra failover. Nilai {i>default- |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Jika kata kunci HostNameInCertificate tidak diatur, driver menggunakan nilai kata kunci Server pada URL koneksi sebagai nama host untuk memvalidasi sertifikat SQL Server TLS/SSL. CATATAN: Properti ini diabaikan jika sertifikat server tepercaya. Jika Encrypt diatur ke Strict, sertifikat akan selalu divalidasi. |
| Bahasa | SSPROP_INIT_CURRENTLANGUAGE | Bahasa SQL Server. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Mengaktifkan atau menonaktifkan beberapa kumpulan hasil aktif (MARS) pada koneksi jika server adalah SQL Server 2005 (9.x) atau yang lebih baru. Nilai yang mungkin adalah yes dan no. Nilai defaultnya adalah no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Selalu tentukan MultiSubnetFailover=Ya saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server atau Instans Kluster Failover SQL Server. MultiSubnetFailover=Ya mengonfigurasi Driver OLE DB untuk SQL Server untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah Yes dan No. Default adalah No. Contohnya:MultiSubnetFailover=YesUntuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Jaring | SSPROP_INIT_NETWORKLIBRARY | Sinonim untuk Jaringan. |
| Jaringan | SSPROP_INIT_NETWORKLIBRARY | Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi. |
| Pustaka Jaringan | SSPROP_INIT_NETWORKLIBRARY | Sinonim untuk Jaringan. |
| Ukuran Paket | SSPROP_INIT_PACKETSIZE | Ukuran paket Tabular Data Stream (TDS). Defaultnya adalah 0 (nilai aktual akan ditentukan oleh server). |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Menerima string yes dan no sebagai nilai. Saat no digunakan, objek sumber data tidak diizinkan untuk mempertahankan informasi autentikasi sensitif |
| PWD | DBPROP_AUTH_PASSWORD | Kata sandi masuk SQL Server. |
| Server | DBPROP_INIT_DATASOURCE | Nama instans SQL Server. Nilai harus berupa nama server di jaringan, alamat IP, atau nama alias Pengelola Konfigurasi SQL Server. Ketika tidak ditentukan, koneksi dibuat ke instans default di komputer lokal. Kata kunci Alamat mengambil alih kata kunci Server . Anda dapat menyambungkan ke instans default di server lokal dengan menentukan salah satu opsi berikut: Server=; Server=.; Server=(lokal); Server=(lokal); Server=(localhost); Server=(localdb)\instancename; Untuk informasi selengkapnya tentang dukungan LocalDB, lihat Driver OLE DB untuk Dukungan SQL Server untuk LocalDB. Untuk menentukan instans SQL Server bernama, tambahkan \InstanceName. Ketika tidak ada server yang ditentukan, koneksi dibuat ke instans default di komputer lokal. Jika Anda menentukan alamat IP, pastikan bahwa protokol TCP/IP atau pipa bernama diaktifkan di Pengelola Konfigurasi SQL Server. Sintaks lengkap untuk kata kunci Server adalah sebagai berikut: Server=[protokol:]Server[,port] protokol dapat berupa tcp (TCP/IP), lpc (memori bersama), atau np (pipa bernama). Contoh berikut menentukan pipa bernama: np:\\.\pipe\MSSQL$MYINST01\sql\queryBaris di atas menentukan protokol pipa bernama ( np), pipa bernama pada komputer lokal (\\.\pipe), nama instans SQL Server (MSSQL$MYINST01), dan nama default pipa bernama (sql/query).Jika tidak ada protokol atau kata kunci Jaringan yang ditentukan, Driver OLE DB untuk SQL Server tidak akan menggunakan urutan protokol yang ditentukan dalam Pengelola Konfigurasi SQL Server. port adalah port yang akan disambungkan, pada server yang ditentukan. Secara default, SQL Server menggunakan port 1433. Spasi diabaikan di awal nilai yang diteruskan ke Server dalam string koneksi saat menggunakan Driver OLE DB untuk SQL Server. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Menentukan jalur ke file sertifikat yang cocok dengan sertifikat SQL Server TLS/SSL. Opsi ini hanya dapat digunakan ketika Strict enkripsi diaktifkan. Format sertifikat yang diterima adalah PEM, DER, dan CER. Jika ditentukan, sertifikat SQL Server diperiksa dengan melihat apakah sertifikat yang disediakan sama persis. |
| ServerSPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| Timeout | DBPROP_INIT_TIMEOUT | Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Mempengaruhi urutan koneksi ketika IP pertama yang diselesaikan dari nama host tidak merespons dan ada beberapa IP yang terkait dengan nama host. TNIR berinteraksi dengan MultiSubnetFailover untuk menyediakan urutan koneksi yang berbeda. Nilai yang mungkin adalah Yes dan No. Nilai defaultnya adalah Yes. Untuk informasi selengkapnya, lihat Menggunakan Resolusi IP Jaringan Transparan. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Ketika yes, opsi ini menginstruksikan Driver OLE DB untuk SQL Server untuk menggunakan Autentikasi Windows untuk validasi masuk. Jika tidak, Driver OLE DB untuk SQL Server akan menggunakan nama pengguna dan kata sandi SQL Server untuk validasi masuk, dan kata kunci UID dan PWD harus ditentukan. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Menerima string yes dan no sebagai nilai. Nilai defaultnya adalah no, yang berarti bahwa sertifikat server akan divalidasi. |
| UID | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| GunakanFMTONLY | SSPROP_INIT_USEFMTONLY | Mengontrol bagaimana metadata diambil saat menyambungkan ke SQL Server 2012 (11.x) dan yang lebih baru. Nilai yang mungkin adalah yes dan no. Nilai defaultnya adalah no.Secara default, Driver OLE DB untuk SQL Server menggunakan prosedur tersimpan sp_describe_first_result_set dan sp_describe_undeclared_parameters untuk mengambil metadata. Prosedur tersimpan ini memiliki beberapa batasan (misalnya, prosedur tersebut akan gagal saat beroperasi pada tabel sementara). Mengatur UseFMTONLY untuk yes menginstruksikan driver untuk menggunakan SET FMTONLY untuk pengambilan metadata sebagai gantinya. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Kata kunci ini tidak digunakan lagi, dan pengaturannya diabaikan oleh Driver OLE DB untuk SQL Server. |
| WSID | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
[1]: Untuk meningkatkan perilaku keamanan, enkripsi, dan validasi sertifikat dimodifikasi saat menggunakan properti inisialisasi Autentikasi atau Token Akses atau kata kunci string koneksi yang sesuai. Untuk informasi selengkapnya, lihat Enkripsi dan validasi sertifikat.
Menggunakan IDataInitialize::GetDataSource
String koneksi yang digunakan oleh aplikasi OLE DB menggunakan IDataInitialize::GetDataSource memiliki sintaks berikut:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
Penggunaan properti harus sesuai dengan sintaks yang diizinkan dalam cakupannya. Misalnya, WSID menggunakan kurung kurawal ({}) karakter kutipan dan Nama Aplikasi menggunakan karakter kutipan (') atau ganda ("). Hanya properti string yang dapat dikutip. Mencoba mengutip bilangan bulat atau properti enumerasi akan mengakibatkan Connection String doesn't conform to OLE DB specification kesalahan.
Nilai atribut secara opsional dapat diapit dalam tanda kutip tunggal atau ganda, dan praktik yang baik untuk melakukannya. Praktik ini menghindari masalah ketika nilai berisi karakter non-alfanumerik. Karakter kutipan yang digunakan juga dapat muncul dalam nilai jika dikutip ganda.
Karakter spasi setelah tanda = kata kunci string koneksi akan ditafsirkan sebagai harfiah, bahkan jika nilai diapit dalam tanda kutip.
Jika string koneksi memiliki lebih dari salah satu properti yang tercantum dalam tabel berikut, nilai properti terakhir akan digunakan.
Tabel berikut ini menjelaskan kata kunci yang dapat digunakan dengan IDataInitialize::GetDataSource:
| Kata kunci | Properti inisialisasi | Deskripsi |
|---|---|---|
| TokenAkses 1 | SSPROP_AUTH_ACCESS_TOKEN | Token akses yang digunakan untuk mengautentikasi ke ID Microsoft Entra. CATATAN: Ini adalah kesalahan untuk menentukan kata kunci ini dan juga UIDkata kunci , , PWD, Trusted_Connectionatau Authentication string koneksi atau properti /kata kunci yang sesuai. |
| Nama Aplikasi | SSPROP_INIT_APPNAME | String yang mengidentifikasi aplikasi. |
| Niat Aplikasi | SSPROP_INIT_APPLICATIONINTENT | Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite.Default adalah ReadWrite. Untuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Autentikasi1 | SSPROP_AUTH_MODE | Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah:
CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan Integrated Security kata kunci autentikasi (atau Trusted_Connection) . Disarankan agar aplikasi yang menggunakan Integrated Security (atau Trusted_Connection) kata kunci atau properti terkaitnya menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk ActiveDirectoryIntegrated mengaktifkan perilaku enkripsi dan validasi sertifikat baru.CATATAN: Disarankan agar aplikasi yang menggunakan SQL Server autentikasi mengatur nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku enkripsi dan validasi sertifikat baru. |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah true dan false. |
| Batas Waktu Sambungkan | DBPROP_INIT_TIMEOUT | Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai. |
| Hubungkan Jumlah Coba Lagi | SSPROP_INIT_CONNECT_RETRY_COUNT | Mengontrol jumlah upaya koneksi ulang jika koneksi hilang. Nilai yang valid berkisar dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk menyambungkan kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| Sambungkan Interval Coba Lagi | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Nilai yang valid berkisar dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| Bahasa Saat Ini | SSPROPT_INIT_CURRENTLANGUAGE | Nama bahasa SQL Server. |
| Sumber data | DBPROP_INIT_DATASOURCE | Nama instans SQL Server dalam organisasi. Ketika tidak ditentukan, koneksi dibuat ke instans default di komputer lokal. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Server , dalam artikel ini. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Menentukan mode penanganan jenis data yang akan digunakan. Nilai yang dikenali adalah 0 untuk jenis data penyedia dan 80 untuk jenis data SQL Server 2000 (8.x). |
| Mitra Failover | SSPROP_INIT_FAILOVERPARTNER | Nama server failover yang digunakan untuk pencerminan database. |
| SPN Mitra Failover | SSPROP_INIT_FAILOVERPARTNERSPN | SPN untuk mitra failover. Nilai {i>default- |
| Nama host dalam sertifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Jika kata kunci Nama Host Dalam Sertifikat tidak diatur, driver menggunakan nilai kata kunci Sumber Data pada URL koneksi sebagai nama host untuk memvalidasi sertifikat SQL Server TLS/SSL. CATATAN: Properti ini diabaikan jika sertifikat server tepercaya. Jika Gunakan Enkripsi untuk Data diatur ke Strict, sertifikat akan selalu divalidasi. |
| Katalog Awal | DBPROP_INIT_CATALOG | Nama database. |
| Nama File Awal | SSPROP_INIT_FILENAME | Nama file utama (sertakan nama jalur lengkap) dari database yang dapat dilampirkan. Untuk menggunakan AttachDBFileName, Anda juga harus menentukan nama database dengan kata kunci DATABASE string penyedia. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali (database tersebut menggunakan database terlampir sebagai default untuk koneksi). |
| Keamanan Terintegrasi | DBPROP_AUTH_INTEGRATED | Menerima nilai SSPI untuk Autentikasi Windows. |
| Koneksi MARS | SSPROP_INIT_MARSCONNECTION | Mengaktifkan atau menonaktifkan beberapa kumpulan hasil aktif (MARS) pada koneksi. Nilai yang dikenali adalah true dan false. Default adalah false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Selalu tentukan MultiSubnetFailover=True saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server atau Instans Kluster Failover SQL Server. MultiSubnetFailover=True mengonfigurasi Driver OLE DB untuk SQL Server untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah True dan False. Default adalah False. Contohnya:MultiSubnetFailover=TrueUntuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Alamat Jaringan | SSPROP_INIT_NETWORKADDRESS | Alamat jaringan instans SQL Server di organisasi. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Alamat , dalam artikel ini. |
| Pustaka Jaringan | SSPROP_INIT_NETWORKLIBRARY | Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi. |
| Ukuran Paket | SSPROP_INIT_PACKETSIZE | Ukuran paket Tabular Data Stream (TDS). Defaultnya adalah 0 (nilai aktual akan ditentukan oleh server). |
| Password | DBPROP_AUTH_PASSWORD | Kata sandi masuk SQL Server. |
| Pertahankan Info Keamanan | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Menerima string true dan false sebagai nilai. Ketika false, objek sumber data tidak diizinkan untuk mempertahankan informasi autentikasi sensitif |
| Penyedia | Untuk Driver OLE DB untuk SQL Server, nilai ini harus "MSOLEDBSQL19" atau "MSOLEDBSQL". | |
| Sertifikat Server | SSPROP_INIT_SERVER_CERTIFICATE | Menentukan jalur ke file sertifikat yang cocok dengan sertifikat SQL Server TLS/SSL. Opsi ini hanya dapat digunakan ketika Strict enkripsi diaktifkan. Format sertifikat yang diterima adalah PEM, DER, dan CER. Jika ditentukan, sertifikat SQL Server diperiksa dengan melihat apakah sertifikat yang disediakan sama persis. |
| Server SPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Mempengaruhi urutan koneksi ketika IP pertama yang diselesaikan dari nama host tidak merespons dan ada beberapa IP yang terkait dengan nama host. TNIR berinteraksi dengan MultiSubnetFailover untuk menyediakan urutan koneksi yang berbeda. Nilai yang mungkin adalah True dan False. Nilai defaultnya adalah True. Untuk informasi selengkapnya, lihat Menggunakan Resolusi IP Jaringan Transparan. |
| SertifikatServer Kepercayaan 1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Menerima string true dan false sebagai nilai. Nilai defaultnya adalah false, yang berarti bahwa sertifikat server akan divalidasi. |
| Menggunakan Enkripsi untuk Data1 | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang memungkinkan adalah Optional, Mandatory, dan Strict. Nilai defaultnya adalah Mandatory. Untuk versi 18.x.x, lihat Perbedaan versi utama MSOLEDBSQL. |
| Menggunakan FMTONLY | SSPROP_INIT_USEFMTONLY | Mengontrol bagaimana metadata diambil saat menyambungkan ke SQL Server 2012 (11.x) dan yang lebih baru. Nilai yang mungkin adalah true dan false. Nilai defaultnya adalah false.Secara default, Driver OLE DB untuk SQL Server menggunakan prosedur tersimpan sp_describe_first_result_set dan sp_describe_undeclared_parameters untuk mengambil metadata. Prosedur tersimpan ini memiliki beberapa batasan (misalnya, prosedur tersebut akan gagal saat beroperasi pada tabel sementara). Pengaturan Gunakan FMTONLY untuk true menginstruksikan driver untuk menggunakan SET FMTONLY untuk pengambilan metadata sebagai gantinya. |
| ID Pengguna | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| ID Stasiun Kerja | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
[1]: Untuk meningkatkan keamanan, enkripsi, dan perilaku validasi sertifikat dimodifikasi saat menggunakan properti inisialisasi Token Autentikasi/Akses atau kata kunci string koneksi yang sesuai. Untuk detailnya, lihat Enkripsi dan validasi sertifikat.
Catatan
Dalam string koneksi, Old Password properti menetapkan SSPROP_AUTH_OLD_PASSWORD, yang merupakan kata sandi saat ini (mungkin kedaluwarsa) yang tidak tersedia melalui properti string penyedia.
Kata Kunci String Koneksi Objek Data ActiveX (ADO)
Aplikasi ADO mengatur properti ConnectionString objek ADODBConnection atau menyediakan string koneksi sebagai parameter ke metode Terbuka objek ADODBConnection.
Aplikasi ADO juga dapat menggunakan kata kunci yang digunakan oleh metode OLE DB IDBInitialize ::Initialize , tetapi hanya untuk properti yang tidak memiliki nilai default. Jika aplikasi menggunakan kata kunci ADO dan kata kunci IDBInitialize::Initialize dalam string inisialisasi, pengaturan kata kunci ADO akan digunakan. disarankan agar aplikasi hanya menggunakan kata kunci ADO string koneksi.
String koneksi yang digunakan oleh ADO memiliki sintaks berikut:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Nilai atribut secara opsional dapat diapit dalam tanda kutip ganda, dan praktik yang baik untuk melakukannya. Praktik ini menghindari masalah ketika nilai berisi karakter non-alfanumerik. Nilai atribut tidak boleh berisi tanda kutip ganda.
Tabel berikut ini menjelaskan kata kunci yang dapat digunakan dengan string koneksi ADO:
| Kata kunci | Properti inisialisasi | Deskripsi |
|---|---|---|
| TokenAkses 1 | SSPROP_AUTH_ACCESS_TOKEN | Token akses yang digunakan untuk mengautentikasi ke ID Microsoft Entra. CATATAN: Ini adalah kesalahan untuk menentukan kata kunci ini dan juga UIDkata kunci , , PWD, Trusted_Connectionatau Authentication string koneksi atau properti /kata kunci yang sesuai. |
| Niat Aplikasi | SSPROP_INIT_APPLICATIONINTENT | Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite.Default adalah ReadWrite. Untuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Nama Aplikasi | SSPROP_INIT_APPNAME | String yang mengidentifikasi aplikasi. |
| Autentikasi1 | SSPROP_AUTH_MODE | Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah:
CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan Integrated Security kata kunci autentikasi (atau Trusted_Connection) . Disarankan agar aplikasi yang menggunakan Integrated Security (atau Trusted_Connection) kata kunci atau properti terkaitnya menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk ActiveDirectoryIntegrated mengaktifkan perilaku enkripsi dan validasi sertifikat baru.CATATAN: Disarankan agar aplikasi yang menggunakan SQL Server autentikasi mengatur nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku enkripsi dan validasi sertifikat baru. |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah true dan false. |
| Batas Waktu Sambungkan | DBPROP_INIT_TIMEOUT | Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai. |
| Hubungkan Jumlah Coba Lagi | SSPROP_INIT_CONNECT_RETRY_COUNT | Mengontrol jumlah upaya koneksi ulang jika koneksi hilang. Nilai yang valid berkisar dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk menyambungkan kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| Sambungkan Interval Coba Lagi | SSPROP_INIT_CONNECT_RETRY_INTERVAL | Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Nilai yang valid berkisar dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Diam. |
| Bahasa Saat Ini | SSPROPT_INIT_CURRENTLANGUAGE | Nama bahasa SQL Server. |
| Sumber data | DBPROP_INIT_DATASOURCE | Nama instans SQL Server dalam organisasi. Ketika tidak ditentukan, koneksi dibuat ke instans default di komputer lokal. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Server , dalam artikel ini. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Menentukan mode penanganan jenis data yang akan digunakan. Nilai yang dikenali adalah 0 untuk jenis data penyedia dan 80 untuk jenis data SQL Server 2000. |
| Mitra Failover | SSPROP_INIT_FAILOVERPARTNER | Nama server failover yang digunakan untuk pencerminan database. |
| SPN Mitra Failover | SSPROP_INIT_FAILOVERPARTNERSPN | SPN untuk mitra failover. Nilai {i>default- |
| Nama host dalam sertifikat | SSPROP_INIT_HOST_NAME_CERTIFICATE | Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Jika kata kunci Nama Host Dalam Sertifikat tidak diatur, driver menggunakan nilai kata kunci Sumber Data pada URL koneksi sebagai nama host untuk memvalidasi sertifikat SQL Server TLS/SSL. CATATAN: Properti ini diabaikan jika sertifikat server tepercaya. Jika Gunakan Enkripsi untuk Data diatur ke Strict, sertifikat akan selalu divalidasi. |
| Katalog Awal | DBPROP_INIT_CATALOG | Nama database. |
| Nama File Awal | SSPROP_INIT_FILENAME | Nama file utama (sertakan nama jalur lengkap) dari database yang dapat dilampirkan. Untuk menggunakan AttachDBFileName, Anda juga harus menentukan nama database dengan kata kunci DATABASE string penyedia. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali (database tersebut menggunakan database terlampir sebagai default untuk koneksi). |
| Keamanan Terintegrasi | DBPROP_AUTH_INTEGRATED | Menerima nilai SSPI untuk Autentikasi Windows. |
| Koneksi MARS | SSPROP_INIT_MARSCONNECTION | Mengaktifkan atau menonaktifkan beberapa kumpulan hasil aktif (MARS) pada koneksi jika server adalah SQL Server 2005 (9.x) atau yang lebih baru. Nilai yang dikenali adalah true dan false. Default adalah false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Selalu tentukan MultiSubnetFailover=True saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server atau Instans Kluster Failover SQL Server. MultiSubnetFailover=True mengonfigurasi Driver OLE DB untuk SQL Server untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah True dan False. Default adalah False. Contohnya:MultiSubnetFailover=TrueUntuk informasi selengkapnya tentang Driver OLE DB untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Driver OLE DB untuk Dukungan SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Alamat Jaringan | SSPROP_INIT_NETWORKADDRESS | Alamat jaringan instans SQL Server di organisasi. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Alamat , dalam artikel ini. |
| Pustaka Jaringan | SSPROP_INIT_NETWORKLIBRARY | Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi. |
| Ukuran Paket | SSPROP_INIT_PACKETSIZE | Ukuran paket Tabular Data Stream (TDS). Defaultnya adalah 0 (nilai aktual akan ditentukan oleh server). |
| Password | DBPROP_AUTH_PASSWORD | Kata sandi masuk SQL Server. |
| Pertahankan Info Keamanan | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Menerima string true dan false sebagai nilai. Ketika false, objek sumber data tidak diizinkan untuk mempertahankan informasi autentikasi sensitif. |
| Penyedia | Untuk Driver OLE DB untuk SQL Server, nilainya adalah MSOLEDBSQL19 atau MSOLEDBSQL. |
|
| Sertifikat Server | SSPROP_INIT_SERVER_CERTIFICATE | Menentukan jalur ke file sertifikat yang cocok dengan sertifikat SQL Server TLS/SSL. Opsi ini hanya dapat digunakan ketika Strict enkripsi diaktifkan. Format sertifikat yang diterima adalah PEM, DER, dan CER. Jika ditentukan, sertifikat SQL Server diperiksa dengan melihat apakah sertifikat yang disediakan sama persis. |
| Server SPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Mempengaruhi urutan koneksi ketika IP pertama yang diselesaikan dari nama host tidak merespons dan ada beberapa IP yang terkait dengan nama host. TNIR berinteraksi dengan MultiSubnetFailover untuk menyediakan urutan koneksi yang berbeda. Nilai yang mungkin adalah True dan False. Nilai defaultnya adalah True. Untuk informasi selengkapnya, lihat Menggunakan Resolusi IP Jaringan Transparan. |
| SertifikatServer Kepercayaan 1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Menerima string true dan false sebagai nilai. Nilai defaultnya adalah false, yang berarti bahwa sertifikat server akan divalidasi. |
| Menggunakan Enkripsi untuk Data1 | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang memungkinkan adalah Optional, Mandatory, dan Strict. Nilai defaultnya adalah Mandatory. Untuk versi 18.x.x, lihat Perbedaan versi utama MSOLEDBSQL. |
| Menggunakan FMTONLY | SSPROP_INIT_USEFMTONLY | Mengontrol bagaimana metadata diambil saat menyambungkan ke SQL Server 2012 (11.x) dan yang lebih baru. Nilai yang mungkin adalah true dan false. Nilai defaultnya adalah false.Secara default, Driver OLE DB untuk SQL Server menggunakan prosedur tersimpan sp_describe_first_result_set dan sp_describe_undeclared_parameters untuk mengambil metadata. Prosedur tersimpan ini memiliki beberapa batasan (misalnya, prosedur tersebut akan gagal saat beroperasi pada tabel sementara). Pengaturan Gunakan FMTONLY untuk true menginstruksikan driver untuk menggunakan SET FMTONLY untuk pengambilan metadata sebagai gantinya. |
| ID Pengguna | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| ID Stasiun Kerja | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
[1]: Untuk meningkatkan keamanan, enkripsi, dan perilaku validasi sertifikat dimodifikasi saat menggunakan properti inisialisasi Token Autentikasi/Akses atau kata kunci string koneksi yang sesuai. Untuk detailnya, lihat Enkripsi dan validasi sertifikat.
Catatan
Dalam string koneksi, properti "Kata Sandi Lama" menetapkan SSPROP_AUTH_OLD_PASSWORD, yang merupakan kata sandi saat ini (mungkin kedaluwarsa) yang tidak tersedia melalui properti string penyedia.