Menggunakan Kata Kunci String Koneksi dengan Driver OLE DB untuk SQL Server

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

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 dapat diizinkan dengan resolusi berdasarkan posisi atau prioritas). Rilis Driver OLE DB untuk SQL Server di masa mendatang mungkin tidak mengizinkan ambiguitas dalam string koneksi. ini adalah praktik yang baik ketika memodifikasi aplikasi untuk menggunakan Driver OLE DB untuk SQL Server untuk menghilangkan dependensi 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 di 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 terkait 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 kata kunci IDBInitialize::Initialize di string koneksi IDataInitialize:GetDataSource , karena perilaku ini mungkin tidak dipertahankan dalam rilis mendatang.

Catatan

String koneksi yang diteruskan melalui 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-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 adalah 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:

[protokol:] 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 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.

Defaultnya 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 Direktori Aktif yang digunakan. Nilai yang valid adalah:
  • (not set): Mode autentikasi ditentukan oleh kata kunci lain.
  • ActiveDirectoryPassword:ID pengguna dan autentikasi kata sandi dengan identitas Azure Active Directory.
  • ActiveDirectoryIntegrated: Autentikasi terintegrasi dengan identitas Azure Active Directory.

  • CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows untuk SQL Server. Ini menggantikan Integrated Security (atau Trusted_Connection) kata kunci autentikasi. 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.

  • ActiveDirectoryInteractive: Autentikasi interaktif dengan identitas Azure Active Directory. Metode ini mendukung Autentikasi Multifaktor (MFA) Azure Active Directory.
  • ActiveDirectoryMSI:Autentikasi Identitas Terkelola (MSI). Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna.
  • ActiveDirectoryServicePrincipal: Autentikasi dengan perwakilan layanan Azure Active Directory. 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:Disarankan agar aplikasi yang menggunakan SQL Server autentikasi menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku validasi enkripsi dan sertifikat baru.
Terjemahkan Otomatis SSPROP_INIT_AUTOTRANSLATE Sinonim untuk AutoTranslate.
Terjemahkan Otomatis 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. Rentang nilai yang valid dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk menyambungkan kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
ConnectRetryInterval SSPROP_INIT_CONNECT_RETRY_INTERVAL Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Rentang nilai yang valid dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
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 SQL Server 2000 jenis data.
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 default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
HostNameInCertificate SSPROP_INIT_HOST_NAME_CERTIFICATE Nama host yang akan digunakan dalam memvalidasi sertifikat TLS/SSL SQL Server. Jika kata kunci HostNameInCertificate tidak diatur, driver menggunakan nilai kata kunci Server pada URL koneksi sebagai nama host untuk memvalidasi sertifikat TLS/SSL SQL Server.
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 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. Defaultnya 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.
Bersih SSPROP_INIT_NETWORKLIBRARY Sinonim untuk Jaringan.
Jaringan SSPROP_INIT_NETWORKLIBRARY Pustaka jaringan digunakan untuk membuat koneksi ke instans SQL Server dalam 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=(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 kata kunci Server adalah sebagai berikut:

Server=[protocol:]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 protokol maupun kata kunci Jaringan tidak ditentukan, Driver OLE DB untuk SQL Server 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 TLS/SSL SQL Server. 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 default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
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 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 login 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). Mengatur UseFMTONLY untuk yes menginstruksikan driver 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 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.

Menggunakan 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 kurung kurawal ({}) karakter kutipan dan Nama Aplikasi menggunakan karakter kutipan (') atau ganda ("). Hanya properti string yang dapat dikutip. Mencoba mengutip bilangan bulat atau properti yang dijumlahkan 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 adalah 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
Token Akses1 SSPROP_AUTH_ACCESS_TOKEN Token akses yang digunakan untuk mengautentikasi ke Azure Active Directory.

CATATAN: Ini adalah kesalahan untuk menentukan kata kunci ini dan juga UIDkata kunci string koneksi , PWD, Trusted_Connection, atau Authentication 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.

Defaultnya 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 Direktori Aktif yang digunakan. Nilai yang valid adalah:
  • (not set): Mode autentikasi ditentukan oleh kata kunci lain.
  • ActiveDirectoryPassword:ID pengguna dan autentikasi kata sandi dengan identitas Azure Active Directory.
  • ActiveDirectoryIntegrated: Autentikasi terintegrasi dengan identitas Azure Active Directory.

  • CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows untuk SQL Server. Ini menggantikan Integrated Security (atau Trusted_Connection) kata kunci autentikasi. 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.

  • ActiveDirectoryInteractive: Autentikasi interaktif dengan identitas Azure Active Directory. Metode ini mendukung Autentikasi Multifaktor (MFA) Azure Active Directory.
  • ActiveDirectoryMSI:Autentikasi Identitas Terkelola (MSI). Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna.
  • ActiveDirectoryServicePrincipal: Autentikasi dengan perwakilan layanan Azure Active Directory. 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:Disarankan agar aplikasi yang menggunakan SQL Server autentikasi menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku validasi enkripsi dan 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. Rentang nilai yang valid dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk terhubung kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
Sambungkan Interval Coba Lagi SSPROP_INIT_CONNECT_RETRY_INTERVAL Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Rentang nilai yang valid dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
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 default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
Nama host dalam sertifikat SSPROP_INIT_HOST_NAME_CERTIFICATE Nama host yang akan digunakan dalam memvalidasi sertifikat TLS/SSL SQL Server. 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. Defaultnya 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 guna memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah True dan False. Defaultnya 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.
Alamat Jaringan SSPROP_INIT_NETWORKADDRESS Alamat jaringan instans SQL Server dalam 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).
Kata sandi 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 TLS/SSL SQL Server. 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 default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
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.
Sertifikat Server Kepercayaan1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Menerima string true dan false sebagai nilai. Nilai defaultnya adalah false, yang berarti bahwa sertifikat server akan divalidasi.
Gunakan 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 login 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 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 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 string koneksi ADO.

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 dapat digunakan dengan string koneksi ADO:

Kata kunci Properti inisialisasi Deskripsi
Token Akses1 SSPROP_AUTH_ACCESS_TOKEN Token akses yang digunakan untuk mengautentikasi ke Azure Active Directory.

CATATAN: Ini adalah kesalahan untuk menentukan kata kunci ini dan juga UIDkata kunci string koneksi , PWD, Trusted_Connection, atau Authentication 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.

Defaultnya 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 Direktori Aktif yang digunakan. Nilai yang valid adalah:
  • (not set): Mode autentikasi ditentukan oleh kata kunci lain.
  • ActiveDirectoryPassword:ID pengguna dan autentikasi kata sandi dengan identitas Azure Active Directory.
  • ActiveDirectoryIntegrated: Autentikasi terintegrasi dengan identitas Azure Active Directory.

  • CATATAN: Kata ActiveDirectoryIntegrated kunci juga dapat digunakan untuk autentikasi Windows untuk SQL Server. Ini menggantikan Integrated Security (atau Trusted_Connection) kata kunci autentikasi. 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.

  • ActiveDirectoryInteractive: Autentikasi interaktif dengan identitas Azure Active Directory. Metode ini mendukung Autentikasi Multifaktor (MFA) Azure Active Directory.
  • ActiveDirectoryMSI:Autentikasi Identitas Terkelola (MSI). Untuk identitas yang ditetapkan pengguna, ID pengguna harus diatur ke ID objek identitas pengguna.
  • ActiveDirectoryServicePrincipal: Autentikasi dengan perwakilan layanan Azure Active Directory. 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:Disarankan agar aplikasi yang menggunakan SQL Server autentikasi menetapkan nilai Authentication kata kunci (atau properti yang sesuai) untuk SqlPassword mengaktifkan perilaku validasi enkripsi dan 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. Rentang nilai yang valid dari 0 hingga 255. Nilai defaultnya adalah 1. Nilai 0 tidak akan menghasilkan upaya untuk terhubung kembali. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
Sambungkan Interval Coba Lagi SSPROP_INIT_CONNECT_RETRY_INTERVAL Menentukan jumlah detik antara setiap upaya coba lagi koneksi jika koneksi hilang. Rentang nilai yang valid dari 1 hingga 60. Nilai defaultnya adalah 10. Untuk informasi selengkapnya, lihat Ketahanan Koneksi Menganggur.
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 tipe data yang akan digunakan. Nilai yang dikenali adalah 0 untuk jenis data penyedia dan 80 untuk SQL Server 2000 jenis data.
Mitra Failover SSPROP_INIT_FAILOVERPARTNER Nama server failover yang digunakan untuk pencerminan database.
SPN Mitra Failover SSPROP_INIT_FAILOVERPARTNERSPN SPN untuk mitra failover. Nilai default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
Nama Host dalam Sertifikat SSPROP_INIT_HOST_NAME_CERTIFICATE Nama host yang akan digunakan dalam memvalidasi sertifikat TLS/SSL SQL Server. 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 TLS/SSL SQL Server.
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 SQL Server 2005 (9.x) atau yang lebih baru. Nilai yang dikenali adalah true dan false. Defaultnya 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. Defaultnya 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.
Alamat Jaringan SSPROP_INIT_NETWORKADDRESS Alamat jaringan instans SQL Server dalam organisasi.

Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Alamat , dalam artikel ini.
Pustaka Jaringan SSPROP_INIT_NETWORKLIBRARY Pustaka jaringan digunakan untuk membuat koneksi ke instans SQL Server dalam organisasi.
Ukuran Paket SSPROP_INIT_PACKETSIZE Ukuran paket Tabular Data Stream (TDS). Defaultnya adalah 0 (nilai aktual akan ditentukan oleh server).
Kata sandi 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 untuk dicocokkan dengan sertifikat TLS/SSL SQL Server. 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 default-nya adalah untaian kosong. String kosong menyebabkan Driver OLE DB untuk SQL Server menggunakan SPN default yang dihasilkan penyedia.
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.
Sertifikat Server Kepercayaan1 SSPROP_INIT_TRUST_SERVER_CERTIFICATE Menerima string true dan false sebagai nilai. Nilai defaultnya adalah false, yang berarti bahwa sertifikat server akan divalidasi.
Gunakan 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.
Gunakan 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 login SQL Server.
ID Stasiun Kerja SSPROP_INIT_WSID Pengidentifikasi stasiun kerja.

[1]: Untuk meningkatkan keamanan, perilaku validasi enkripsi dan 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, properti "Kata Sandi Lama" menetapkan SSPROP_AUTH_OLD_PASSWORD, yang merupakan kata sandi saat ini (mungkin kedaluwarsa) yang tidak tersedia melalui properti string penyedia.

Lihat juga

Membangun Aplikasi dengan Driver OLE DB untuk SQL Server