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 Sistem Platform Analitik (PDW)Database SQL di Microsoft Fabric

Unduh driver OLE DB

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 mungkin 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 DBPROPSET_DBINIT kumpulan properti. Dalam kasus kedua, string inisialisasi dapat diteruskan ke IDataInitialize::GetDataSource metode 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 setidaknya mencakup 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 menggunakan nilai DBPROP_INIT_PROVIDERSTRING diatur dengan 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 dalam IDataInitialize:GetDataSource string koneksi, karena perilaku ini mungkin tidak dipertahankan dalam rilis mendatang.

Catatan

String koneksi yang diteruskan 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 DBPROP_PROVIDERSTRING properti. Misalnya, jika Anda menentukan string Data Source=server1;Server=server2 koneksi, Data Source akan diatur sebagai properti, tetapi Server akan dimasukkan ke dalam 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-string
empty-string ::=
attribute ::= attribute-keyword=[{]attribute-value[}]
attribute-value ::= character-string
attribute-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 `Address`.
`Address`	`SSPROP_INIT_NETWORKADDRESS`	Alamat jaringan server yang menjalankan instans SQL Server. `Address` biasanya adalah nama jaringan server, tetapi bisa menjadi 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 `Address` diutamakan daripada nilai yang diteruskan ke `Server` dalam string koneksi saat menggunakan Driver OLE DB untuk SQL Server. `Address=;` menyambungkan 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 `Address` kata kunci adalah sebagai berikut: [protokol:]Alamat[,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 protokol atau `Network` kata kunci tidak ditentukan, Driver OLE DB untuk SQL Server akan menggunakan urutan protokol yang ditentukan di SQL Server Configuration Manager. 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).
`Authentication` ¹	`SSPROP_AUTH_MODE`	Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah: `(not set)`: Mode autentikasi ditentukan oleh kata kunci lain. `ActiveDirectoryPassword`: ID pengguna dan autentikasi kata sandi dengan identitas Microsoft Entra. `ActiveDirectoryIntegrated`: Autentikasi terintegrasi dengan ID Microsoft Entra. Catatan: Kata `ActiveDirectoryIntegrated` kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan `Integrated Security` kata kunci autentikasi (atau `Trusted_Connection`) . Aplikasi yang menggunakan `Integrated Security` kata kunci (atau `Trusted_Connection`) atau properti yang sesuai harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `ActiveDirectoryIntegrated` mengaktifkan perilaku validasi enkripsi dan sertifikat baru. `ActiveDirectoryInteractive`: Autentikasi interaktif dengan identitas Microsoft Entra. Metode ini mendukung autentikasi multifaktor Microsoft Entra. `ActiveDirectoryMSI`: Autentikasi Identitas Terkelola . Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna. `ActiveDirectoryServicePrincipal`: Autentikasi dengan perwakilan layanan Microsoft Entra. ID pengguna harus diatur ke ID aplikasi (klien). Kata sandi harus diatur ke rahasia aplikasi (klien). `SqlPassword`: Autentikasi menggunakan ID pengguna dan kata sandi. Catatan: Aplikasi yang menggunakan autentikasi SQL Server harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `SqlPassword` mengaktifkan perilaku enkripsi dan validasi sertifikat baru.
`Auto Translate`	`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 menganggur di Driver OLE DB.
`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 menganggur di Driver OLE DB.
`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 (8.x).
`Encrypt` ¹	`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. `HostNameInCertificate` Jika kata kunci tidak diatur, driver menggunakan `Server` nilai kata kunci 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.
`Language`	`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=Yes` saat menyambungkan ke pendengar grup ketersediaan SQL Server atau Instans Kluster Failover SQL Server. `MultiSubnetFailover=Yes` 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=Yes` 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.
`Net`	`SSPROP_INIT_NETWORKLIBRARY`	Sinonim untuk `Network`.
`Network`	`SSPROP_INIT_NETWORKLIBRARY`	Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Sinonim untuk `Network`.
`PacketSize`	`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 `Address` menimpa kata kunci `Server`. Anda dapat menyambungkan ke instans default di server lokal dengan menentukan salah satu opsi berikut: `Server=;` `Server=.;` `Server=(local);` `Server=(local);` `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 `Server` kata kunci adalah sebagai berikut: [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\query` Baris 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 baik protokol maupun `Network` kata kunci tidak ditentukan, Driver OLE DB untuk SQL Server akan menggunakan urutan protokol yang ditentukan di SQL Server Configuration Manager. 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.
`TrustServerCertificate` ¹	`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.
`UseFMTONLY`	`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). Pengaturan `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.

¹ Untuk meningkatkan keamanan, enkripsi, dan perilaku 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.

Gunakan IDataInitialize::GetDataSource

String koneksi yang digunakan oleh aplikasi OLE DB menggunakan IDataInitialize::GetDataSource memiliki sintaks berikut:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=[quote]attribute-value[quote]
attribute-value ::= character-string
attribute-keyword ::= identifier
quote ::= " | '

Penggunaan properti harus sesuai dengan sintaks yang diizinkan dalam cakupannya. Misalnya, WSID menggunakan karakter kurung kurawal ({}) dan Application Name menggunakan karakter kutipan tunggal (') 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 mungkin digunakan dengan IDataInitialize::GetDataSource:

Kata kunci	Properti inisialisasi	Deskripsi
`Access Token` ¹	`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 `UID`, `PWD`, `Trusted_Connection`, `Authentication`, atau kata kunci string koneksi atau properti/kata kunci yang sesuai.
`Application Name`	`SSPROP_INIT_APPNAME`	String yang mengidentifikasi aplikasi.
`Application Intent`	`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.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah: `(not set)`: Mode autentikasi ditentukan oleh kata kunci lain. `ActiveDirectoryPassword`: ID pengguna dan autentikasi kata sandi dengan identitas Microsoft Entra. `ActiveDirectoryIntegrated`: Autentikasi terintegrasi dengan ID Microsoft Entra. Catatan: Kata `ActiveDirectoryIntegrated` kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan `Integrated Security` kata kunci autentikasi (atau `Trusted_Connection`) . Aplikasi yang menggunakan `Integrated Security` kata kunci (atau `Trusted_Connection`) atau properti yang sesuai harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `ActiveDirectoryIntegrated` mengaktifkan perilaku validasi enkripsi dan sertifikat baru. `ActiveDirectoryInteractive`: Autentikasi interaktif dengan identitas Microsoft Entra. Metode ini mendukung autentikasi multifaktor Microsoft Entra. `ActiveDirectoryMSI`: Autentikasi Identitas Terkelola . Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna. `ActiveDirectoryServicePrincipal`: Autentikasi dengan perwakilan layanan Microsoft Entra. ID pengguna harus diatur ke ID aplikasi (klien). Kata sandi harus diatur ke rahasia aplikasi (klien). `SqlPassword`: Autentikasi menggunakan ID pengguna dan kata sandi. Catatan: Aplikasi yang menggunakan autentikasi SQL Server harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `SqlPassword` mengaktifkan perilaku enkripsi dan validasi sertifikat baru.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah `true` dan `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai.
`Connect Retry Count`	`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 menganggur di Driver OLE DB.
`Connect Retry Interval`	`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 menganggur di Driver OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	Nama bahasa SQL Server.
`Data Source`	`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 `Server` kata kunci, 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).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	Nama server failover yang digunakan untuk pencerminan database.
`Failover Partner SPN`	`SSPROP_INIT_FAILOVERPARTNERSPN`	SPN untuk mitra failover. Nilai {i>default-
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. `Host Name In Certificate` Jika kata kunci tidak diatur, driver menggunakan `Data Source` nilai kata kunci pada URL koneksi sebagai nama host untuk memvalidasi sertifikat SQL Server TLS/SSL. Catatan: Properti ini diabaikan jika sertifikat server tepercaya. Jika `Use Encryption for Data` diatur ke `Strict`, sertifikat akan selalu divalidasi.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	Nama database.
`Initial File Name`	`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 string kata kunci `DATABASE` penyedia. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali (database tersebut menggunakan database terlampir sebagai default untuk koneksi).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Menerima nilai `SSPI` untuk Autentikasi Windows.
`MARS Connection`	`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 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=True` 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.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	Alamat jaringan instans SQL Server di organisasi. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi `Address` kata kunci, dalam artikel ini.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi.
`Packet Size`	`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.
`Persist Security Info`	`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	Menerima string `true` dan `false` sebagai nilai. Ketika `false`, objek sumber data tidak diizinkan untuk mempertahankan informasi autentikasi sensitif
`Provider`		Untuk Driver OLE DB untuk SQL Server, nilainya adalah `MSOLEDBSQL19` atau `MSOLEDBSQL`.
`Server Certificate`	`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.
`Trust Server Certificate` ¹	`SSPROP_INIT_TRUST_SERVER_CERTIFICATE`	Menerima string `true` dan `false` sebagai nilai. Nilai defaultnya adalah `false`, yang berarti bahwa sertifikat server akan divalidasi.
`Use Encryption for Data` ¹	`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.
`Use 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 `Use FMTONLY` untuk `true` menginstruksikan driver untuk menggunakan SET FMTONLY untuk pengambilan metadata sebagai gantinya.
`User ID`	`DBPROP_AUTH_USERID`	Nama masuk SQL Server.
`Workstation ID`	`SSPROP_INIT_WSID`	Pengidentifikasi stasiun kerja.

¹ Untuk meningkatkan perilaku keamanan, enkripsi, dan validasi sertifikat dimodifikasi saat menggunakan properti inisialisasi Autentikasi/Token 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 ActiveX Data Objects (ADO)

Aplikasi ADO mengatur properti ConnectionString dari objek ADODBConnection atau menyediakan string koneksi sebagai parameter untuk metode Open dari 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 IDBInitialize::Initialize kata kunci 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-string
empty-string ::=
attribute ::= attribute-keyword=["]attribute-value["]
attribute-value ::= character-string
attribute-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 mungkin digunakan dengan string koneksi ADO:

Kata kunci	Properti inisialisasi	Deskripsi
`Access Token` ¹	`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 kata kunci string koneksi `UID`, `PWD`, `Trusted_Connection`, atau `Authentication` atau properti/kata kunci yang sesuai.
`Application Intent`	`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.
`Application Name`	`SSPROP_INIT_APPNAME`	String yang mengidentifikasi aplikasi.
`Authentication` ¹	`SSPROP_AUTH_MODE`	Menentukan autentikasi SQL atau Microsoft Entra yang digunakan. Nilai yang valid adalah: `(not set)`: Mode autentikasi ditentukan oleh kata kunci lain. `ActiveDirectoryPassword`: ID pengguna dan autentikasi kata sandi dengan identitas Microsoft Entra. `ActiveDirectoryIntegrated`: Autentikasi terintegrasi dengan ID Microsoft Entra. Catatan: Kata `ActiveDirectoryIntegrated` kunci juga dapat digunakan untuk autentikasi Windows ke SQL Server. Ini menggantikan `Integrated Security` kata kunci autentikasi (atau `Trusted_Connection`) . Aplikasi yang menggunakan `Integrated Security` kata kunci (atau `Trusted_Connection`) atau properti yang sesuai harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `ActiveDirectoryIntegrated` mengaktifkan perilaku validasi enkripsi dan sertifikat baru. `ActiveDirectoryInteractive`: Autentikasi interaktif dengan identitas Microsoft Entra. Metode ini mendukung autentikasi multifaktor Microsoft Entra. `ActiveDirectoryMSI`: Autentikasi Identitas Terkelola . Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna. `ActiveDirectoryServicePrincipal`: Autentikasi dengan perwakilan layanan Microsoft Entra. ID pengguna harus diatur ke ID aplikasi (klien). Kata sandi harus diatur ke rahasia aplikasi (klien). `SqlPassword`: Autentikasi menggunakan ID pengguna dan kata sandi. Catatan: Aplikasi yang menggunakan autentikasi SQL Server harus mengatur nilai `Authentication` kata kunci (atau properti yang sesuai) untuk `SqlPassword` mengaktifkan perilaku enkripsi dan validasi sertifikat baru.
`Auto Translate`	`SSPROP_INIT_AUTOTRANSLATE`	Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah `true` dan `false`.
`Connect Timeout`	`DBPROP_INIT_TIMEOUT`	Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai.
`Connect Retry Count`	`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 menganggur di Driver OLE DB.
`Connect Retry Interval`	`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 menganggur di Driver OLE DB.
`Current Language`	`SSPROPT_INIT_CURRENTLANGUAGE`	Nama bahasa SQL Server.
`Data Source`	`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 `Server` kata kunci, 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).
`Failover Partner`	`SSPROP_INIT_FAILOVERPARTNER`	Nama server failover yang digunakan untuk pencerminan database.
`Failover Partner SPN`	`SSPROP_INIT_FAILOVERPARTNERSPN`	SPN untuk mitra failover. Nilai {i>default-
`Host Name In Certificate`	`SSPROP_INIT_HOST_NAME_CERTIFICATE`	Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. `Host Name In Certificate` Jika kata kunci tidak diatur, driver menggunakan `Data Source` nilai kata kunci pada URL koneksi sebagai nama host untuk memvalidasi sertifikat SQL Server TLS/SSL. Catatan: Properti ini diabaikan jika sertifikat server tepercaya. Jika `Use Encryption for Data` diatur ke `Strict`, sertifikat akan selalu divalidasi.
`Initial Catalog`	`DBPROP_INIT_CATALOG`	Nama database.
`Initial File Name`	`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 string `DATABASE` penyedia. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali (database tersebut menggunakan database terlampir sebagai default untuk koneksi).
`Integrated Security`	`DBPROP_AUTH_INTEGRATED`	Menerima nilai `SSPI` untuk Autentikasi Windows.
`MARS Connection`	`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 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=True` 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.
`Network Address`	`SSPROP_INIT_NETWORKADDRESS`	Alamat jaringan instans SQL Server di organisasi. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi `Address` kata kunci, dalam artikel ini.
`Network Library`	`SSPROP_INIT_NETWORKLIBRARY`	Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi.
`Packet Size`	`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.
`Persist Security Info`	`DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO`	Menerima string `true` dan `false` sebagai nilai. Ketika `false`, objek sumber data tidak diizinkan untuk mempertahankan informasi autentikasi sensitif.
`Provider`		Untuk Driver OLE DB untuk SQL Server, nilainya adalah `MSOLEDBSQL19` atau `MSOLEDBSQL`.
`Server Certificate`	`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.
`Trust Server Certificate` ¹	`SSPROP_INIT_TRUST_SERVER_CERTIFICATE`	Menerima string `true` dan `false` sebagai nilai. Nilai defaultnya adalah `false`, yang berarti bahwa sertifikat server akan divalidasi.
`Use Encryption for Data` ¹	`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.
`Use 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 `Use FMTONLY` untuk `true` menginstruksikan driver untuk menggunakan SET FMTONLY untuk pengambilan metadata sebagai gantinya.
`User ID`	`DBPROP_AUTH_USERID`	Nama masuk SQL Server.
`Workstation ID`	`SSPROP_INIT_WSID`	Pengidentifikasi stasiun kerja.

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.

Membangun aplikasi dengan Driver OLE DB untuk SQL Server

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-12-12

Bagikan melalui

Menggunakan kata kunci string koneksi dengan Driver OLE DB untuk SQL Server

Kata kunci string koneksi Driver OLE DB

Menggunakan IDBInitialize::Initialize

Gunakan IDataInitialize::GetDataSource

Kata kunci string koneksi ActiveX Data Objects (ADO)

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: