Menggunakan Kata Kunci String Koneksi dengan SQL Server Native Client
Berlaku untuk:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)
Penting
SQL Server Native Client (sering disingkat SNAC) telah dihapus dari SQL Server 2022 (16.x) dan SQL Server Management Studio 19 (SSMS). SQL Server Native Client (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan aplikasi baru. Beralih ke Microsoft OLE DB Driver (MSOLEDBSQL) baru untuk SQL Server atau Microsoft ODBC Driver terbaru untuk SQL Server ke depannya. Untuk SQLNCLI yang dikirim sebagai komponen SQL Server Database Engine (versi 2012 hingga 2019), lihat pengecualian Siklus Hidup Dukungan ini.
Beberapa API Klien Asli 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.
Untuk informasi, lihat Menggunakan Kata Kunci String Koneksi dengan Driver OLE DB untuk SQL Server.
Catatan
Klien Asli 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). Ini adalah praktik yang baik saat memodifikasi aplikasi untuk menggunakan SQL Server Native Client untuk menghilangkan dependensi pada ambiguitas string koneksi.
Bagian berikut menjelaskan kata kunci yang dapat digunakan dengan penyedia SQL Server Native Client OLE DB, driver ODBC Klien Asli SQL Server, dan Objek Data ActiveX (ADO) saat menggunakan SQL Server Native Client sebagai penyedia data.
Kata kunci string koneksi Driver ODBC
Aplikasi ODBC menggunakan string koneksi sebagai parameter ke fungsi SQLDriverConnect dan SQLBrowseConnect .
String koneksi yang digunakan oleh ODBC 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 kurung kurawal, dan adalah praktik yang baik untuk melakukannya. 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.
Tabel berikut ini menjelaskan kata kunci yang dapat digunakan dengan string koneksi ODBC.
| Kata kunci | Deskripsi |
|---|---|
| Addr | Sinonim untuk "Alamat". |
| Alamat | 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 SQL Server Configuration Manager. Nilai Alamat lebih diutamakan daripada nilai yang diteruskan ke Server dalam string koneksi ODBC saat menggunakan SQL Server Native Client. 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, SQL Server Native Client 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. |
| AnsiNPW | Ketika "ya", driver menggunakan perilaku yang ditentukan ANSI untuk menangani perbandingan NULL, padding data karakter, peringatan, dan perangkaian NULL. Ketika "tidak", perilaku yang ditentukan ANSI tidak diekspos. Untuk informasi selengkapnya tentang perilaku NPW ANSI, lihat Efek Opsi ISO. |
| APP | Nama aplikasi yang memanggil SQLDriverConnect (opsional). Jika ditentukan, nilai ini disimpan dalam kolom master.dbo.sysprocesses program_name dan dikembalikan oleh sp_who dan fungsi APP_NAME. |
| ApplicationIntent | Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite. Defaultnya adalah ReadWrite. Contohnya:ApplicationIntent=ReadOnlyUntuk informasi selengkapnya tentang dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| AttachDBFileName | Nama file utama database yang dapat dilampirkan. Sertakan jalur lengkap dan keluarkan karakter \ apa pun jika menggunakan variabel string karakter C:AttachDBFileName=c:\\MyFolder\\MyDB.mdfDatabase ini dilampirkan dan menjadi database default untuk koneksi. Untuk menggunakan AttachDBFileName , Anda juga harus menentukan nama database di parameter DATABASE SQLDriverConnect atau atribut koneksi SQL_COPT_CURRENT_CATALOG. Jika database sebelumnya dilampirkan, SQL Server tidak memasangnya kembali; ini menggunakan database terlampir sebagai default untuk koneksi. |
| AutoTranslate | Ketika "ya", string karakter ANSI yang dikirim antara klien dan server diterjemahkan dengan mengonversi melalui Unicode untuk meminimalkan masalah dalam mencocokkan karakter yang diperluas antara halaman kode pada klien dan server. Klien SQL_C_CHAR data yang dikirim ke karakter SQL Server, varchar, atau variabel teks, parameter, atau kolom dikonversi dari karakter ke Unicode menggunakan halaman kode ANSI klien (ACP), lalu dikonversi dari Unicode ke karakter menggunakan ACP server. Data karakter, varchar, atau teks SQL Server yang dikirim ke variabel SQL_C_CHAR klien dikonversi dari karakter ke Unicode menggunakan ACP server, lalu dikonversi dari Unicode ke karakter menggunakan ACP klien. Konversi ini dilakukan pada klien oleh driver ODBC SQL Server Native Client. Ini mengharuskan halaman kode ANSI (ACP) yang sama yang digunakan pada server tersedia di klien. Pengaturan ini tidak berpengaruh pada konversi yang terjadi untuk transfer ini: * Unicode SQL_C_WCHAR data klien yang dikirim ke karakter, varchar, atau teks di server. * data server char, varchar, atau teks yang dikirim ke variabel Unicode SQL_C_WCHAR pada klien. * ANSI SQL_C_CHAR data klien yang dikirim ke Unicode nchar, nvarchar, atau ntext di server. * Data server Unicode nchar, nvarchar, atau ntext yang dikirim ke variabel ansi SQL_C_CHAR pada klien. Ketika "tidak", terjemahan karakter tidak dilakukan. Driver ODBC Klien Asli SQL Server tidak menerjemahkan karakter ANSI klien SQL_C_CHAR data yang dikirim ke variabel karakter, varchar, atau teks , parameter, atau kolom di server. Tidak ada terjemahan yang dilakukan pada data karakter, varchar, atau teks yang dikirim dari server ke variabel SQL_C_CHAR pada klien. Jika klien dan SQL Server menggunakan ACL yang berbeda, karakter yang diperluas mungkin salah disalahartikan. |
| Database | Nama database SQL Server default untuk koneksi. Jika Database tidak ditentukan, database default yang ditentukan untuk login akan digunakan. Database default dari sumber data ODBC mengambil alih database default yang ditentukan untuk login. Database harus berupa database yang sudah ada kecuali AttachDBFileName juga ditentukan. Jika AttachDBFileName juga ditentukan, file utama yang ditujukan untuk dilampirkan dan diberi nama database yang ditentukan oleh Database. |
| Driver | Nama driver sebagaimana dikembalikan oleh SQLDrivers. Nilai kata kunci untuk driver ODBC Klien Asli SQL Server adalah "{SQL Server Native Client 11.0}". Kata kunci Server diperlukan jika Driver ditentukan dan DriverCompletion diatur ke SQL_DRIVER_NOPROMPT. Untuk informasi selengkapnya tentang nama driver, lihat Menggunakan Header Klien Asli SQL Server dan File Pustaka. |
| DSN | Nama pengguna ODBC atau sumber data sistem yang ada. Kata kunci ini mengambil alih nilai apa pun yang mungkin ditentukan dalam kata kunci Server, Jaringan, dan Alamat . |
| Mengenkripsi | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang mungkin adalah "yes"/"mandatory"(18.0+), "no"/"optional"(18.0+), dan "strict"(18.0+). Nilai defaultnya adalah "ya" dalam versi 18.0+ dan "tidak" di versi sebelumnya. |
| Fallback | Kata kunci ini tidak digunakan lagi, dan pengaturannya diabaikan oleh driver ODBC SQL Server Native Client. |
| Failover_Partner | Nama server mitra failover yang akan digunakan jika koneksi tidak dapat dibuat ke server utama. |
| FailoverPartnerSPN | SPN untuk mitra failover. Nilai {i>default- |
| FileDSN | Nama sumber data file ODBC yang ada. |
| Bahasa | Nama bahasa SQL Server (opsional). SQL Server dapat menyimpan pesan untuk beberapa bahasa dalam sysmessages. Jika menyambungkan ke SQL Server dengan beberapa bahasa, Bahasa menentukan kumpulan pesan mana yang digunakan untuk koneksi. |
| MARS_Connection | Mengaktifkan atau menonaktifkan beberapa kumpulan hasil aktif (MARS) pada koneksi. Nilai yang dikenali adalah "ya" dan "tidak". Defaultnya adalah "tidak". |
| MultiSubnetFailover | Selalu tentukan multiSubnetFailover=Ya saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server atau Instans Kluster Failover SQL Server. multiSubnetFailover=Ya mengonfigurasi SQL Server Native Client untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah Ya dan Tidak. Defaultnya adalah Tidak. Contohnya:MultiSubnetFailover=YesUntuk informasi selengkapnya tentang dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Bersih | Sinonim untuk "Jaringan". |
| Jaringan | Nilai yang valid adalah dbnmpntw (pipa bernama) dan dbmssocn (TCP/IP). Ini adalah kesalahan untuk menentukan nilai untuk kata kunci Jaringan dan awalan protokol pada kata kunci Server . |
| PWD | Kata sandi untuk akun masuk SQL Server yang ditentukan dalam parameter UID. PWD tidak perlu ditentukan jika login memiliki kata sandi NULL atau saat menggunakan Autentikasi Windows (Trusted_Connection = yes). |
| QueryLog_On | Ketika "ya", pengelogan data kueri yang berjalan lama diaktifkan pada koneksi. Ketika "tidak", data kueri yang berjalan lama tidak dicatat. |
| QueryLogFile | Jalur lengkap dan nama file file yang akan digunakan untuk mencatat data pada kueri yang berjalan lama. |
| QueryLogTime | String karakter digit yang menentukan ambang batas (dalam milidetik) untuk mencatat kueri yang berjalan lama. Setiap kueri yang tidak mendapatkan respons dalam waktu yang ditentukan ditulis ke file log kueri yang berjalan lama. |
| QuotedId | Ketika "ya", QUOTED_IDENTIFIERS diatur AKTIF untuk koneksi, SQL Server menggunakan aturan ISO mengenai penggunaan tanda kutip dalam pernyataan SQL. Jika tidak, QUOTED_IDENTIFIERS diatur NONAKTIF untuk koneksi. SQL Server kemudian mengikuti aturan Transact-SQL warisan mengenai penggunaan tanda kutip dalam pernyataan SQL. Untuk informasi selengkapnya, lihat Efek Opsi ISO. |
| Regional | Ketika "ya", driver ODBC SQL Server Native Client menggunakan pengaturan klien saat mengonversi data mata uang, tanggal, dan waktu menjadi data karakter. Konversi hanya satu arah; driver tidak mengenali format standar non-ODBC untuk string tanggal atau nilai mata uang di dalamnya; misalnya, parameter yang digunakan dalam pernyataan INSERT atau UPDATE. Ketika "tidak", driver menggunakan string standar ODBC untuk mewakili data mata uang, tanggal, dan waktu yang dikonversi ke data karakter. |
| SaveFile | Nama file sumber data ODBC tempat atribut koneksi saat ini disimpan jika koneksi berhasil. |
| Server | Nama instans SQL Server. Nilai harus berupa nama server di jaringan, alamat IP, atau nama alias Pengelola Konfigurasi SQL Server. Kata kunci Alamat mengambil alih kata kunci Server . Anda dapat menyambungkan ke instans default di server lokal dengan menentukan salah satu hal berikut ini: Server=; Server=.; Server=(lokal); Server=(lokal); Server=(localhost); Server=(localdb)\instancename; Untuk informasi selengkapnya tentang dukungan LocalDB, lihat Dukungan Klien Asli 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 SQL Server Configuration Manager. 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). Berikut ini adalah contoh menentukan pipa bernama: np:\\.\pipe\MSSQL$MYINST01\sql\queryBaris ini menentukan protokol pipa bernama, 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, SQL Server Native Client tidak 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 ODBC saat menggunakan SQL Server Native Client. |
| ServerSPN | SPN untuk server. Nilai {i>default- |
| StatsLog_On | Ketika "ya", memungkinkan pengambilan data performa driver ODBC SQL Server Native Client. Ketika "tidak", data performa driver ODBC Klien Asli SQL Server tidak tersedia pada koneksi. |
| StatsLogFile | Jalur lengkap dan nama file file yang digunakan untuk merekam statistik performa driver ODBC Klien Asli SQL Server. |
| Trusted_Connection | Ketika "ya", menginstruksikan driver ODBC SQL Server Native Client untuk menggunakan Mode Autentikasi Windows untuk validasi masuk. Jika tidak, menginstruksikan driver ODBC SQL Server Native Client untuk menggunakan nama pengguna dan kata sandi SQL Server untuk validasi masuk, dan kata kunci UID dan PWD harus ditentukan. |
| TrustServerCertificate | Saat digunakan dengan Encrypt, mengaktifkan enkripsi menggunakan sertifikat server yang ditandatangani sendiri. |
| UID | Akun masuk SQL Server yang valid. UID tidak perlu ditentukan ketika menggunakan Autentikasi Windows. |
| UseProcForPrepare | Kata kunci ini tidak digunakan lagi, dan pengaturannya diabaikan oleh Driver ODBC SQL Server Native Client. |
| WSID | ID stasiun kerja. Biasanya, ini adalah nama jaringan komputer tempat aplikasi berada (opsional). Jika ditentukan, nilai ini disimpan dalam nama host kolom master.dbo.sysprocesses dan dikembalikan oleh sp_who dan fungsi HOST_NAME. |
Catatan
Pengaturan konversi regional berlaku untuk jenis data mata uang, numerik, tanggal, dan waktu. Pengaturan konversi hanya berlaku untuk konversi output dan hanya terlihat ketika nilai mata uang, numerik, tanggal, atau waktu dikonversi ke string karakter.
Driver ODBC SQL Server Native Client menggunakan pengaturan registri lokal untuk pengguna saat ini. Driver tidak menghormati lokal utas saat ini jika aplikasi mengaturnya setelah koneksi oleh, misalnya, memanggil SetThreadLocale.
Mengubah perilaku regional sumber data dapat menyebabkan kegagalan aplikasi. Aplikasi yang mengurai string tanggal, dan mengharapkan string tanggal muncul seperti yang didefinisikan oleh ODBC, dapat terpengaruh secara merugikan dengan mengubah nilai ini.
Kata Kunci String Koneksi Penyedia 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 "ya" dan "tidak". 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. Sangat disarankan agar aplikasi tidak menggunakan IDBInitialize::Initialize kata kunci dalam 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.
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 dalam kurung kurawal, dan adalah praktik yang baik untuk melakukannya. 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 instans SQL Server di organisasi. Untuk informasi selengkapnya tentang sintaks alamat yang valid, lihat deskripsi kata kunci Alamat ODBC, nanti dalam topik ini. |
| 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 dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli 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). |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Sinonim untuk "AutoTranslate". |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | Mengonfigurasi terjemahan karakter OEM/ANSI. Nilai yang dikenali adalah "ya" dan "tidak". |
| 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. |
| Mengenkripsi | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang mungkin adalah "ya" dan "tidak". Nilai defaultnya adalah "tidak". |
| FailoverPartner | SSPROP_INIT_FAILOVERPARTNER | Nama server failover yang digunakan untuk pencerminan database. |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | SPN untuk mitra failover. Nilai {i>default- |
| 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 "ya" dan "tidak". Nilai defaultnya adalah "tidak". |
| Bersih | 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 jaringan. Defaultnya adalah 4096. |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Menerima string "ya" dan "tidak" sebagai nilai. Ketika "tidak", 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 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 ODBC Server , dalam topik ini. |
| ServerSPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| Timeout | DBPROP_INIT_TIMEOUT | Jumlah waktu (dalam detik) untuk menunggu inisialisasi sumber data selesai. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Ketika "ya", menginstruksikan penyedia SQL Server Native Client OLE DB untuk menggunakan Mode Autentikasi Windows untuk validasi masuk. Jika tidak, menginstruksikan penyedia SQL Server Native Client OLE DB untuk 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 "ya" dan "tidak" sebagai nilai. Nilai defaultnya adalah "tidak", yang berarti bahwa sertifikat server akan divalidasi. |
| UID | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Kata kunci ini tidak digunakan lagi, dan pengaturannya diabaikan oleh Penyedia OLE DB SQL Server Native Client. |
| WSID | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
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 enumerasi akan mengakibatkan kesalahan "String Koneksi tidak sesuai dengan spesifikasi OLE DB".
Nilai atribut secara opsional dapat diapit dalam tanda kutip tunggal atau ganda, dan adalah praktik yang baik untuk melakukannya. Ini menghindari masalah ketika nilai berisi karakter non-alfanumerik. Karakter kutipan yang digunakan juga dapat muncul dalam nilai, asalkan digandakan.
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 |
|---|---|---|
| Nama Aplikasi | SSPROP_INIT_APPNAME | String yang mengidentifikasi aplikasi. |
| Niat Aplikasi | SSPROP_INIT_APPLICATIONINTENT | Sinonim untuk "ApplicationIntent". |
| 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 dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Sinonim untuk "AutoTranslate". |
| AutoTranslate | 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. |
| Bahasa Saat Ini | SSPROP_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 ODBC Server , nanti dalam topik 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- |
| 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". |
| 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 ODBC, nanti dalam topik 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 jaringan. Defaultnya adalah 4096. |
| 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 SQL Server Native Client, ini harus "SQLNCLI11". | |
| Server SPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| Sertifikat Server Kepercayaan | 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 Data | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang mungkin adalah "true" dan "false". Nilai defaultnya adalah "false". |
| ID Pengguna | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| ID Stasiun Kerja | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
Catatan Dalam string koneksi, properti "Kata Sandi Lama" mengatur 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. Sangat 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 adalah praktik yang baik untuk melakukannya. 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 |
|---|---|---|
| Niat Aplikasi | SSPROP_INIT_APPLICATIONINTENT | Sinonim untuk "ApplicationIntent". |
| 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 dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana. |
| Nama Aplikasi | SSPROP_INIT_APPNAME | String yang mengidentifikasi aplikasi. |
| Terjemahkan Otomatis | SSPROP_INIT_AUTOTRANSLATE | Sinonim untuk "AutoTranslate". |
| AutoTranslate | 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. |
| Bahasa Saat Ini | SSPROP_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 ODBC Server , dalam topik 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- |
| 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". Defaultnya adalah "false". |
| 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 ODBC, dalam topik 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 jaringan. Defaultnya adalah 4096. |
| 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 SQL Server Native Client, ini harus "SQLNCLI11". | |
| Server SPN | SSPROP_INIT_SERVERSPN | SPN untuk server. Nilai {i>default- |
| Sertifikat Server Kepercayaan | 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 Data | SSPROP_INIT_ENCRYPT | Menentukan apakah data harus dienkripsi sebelum mengirimkannya melalui jaringan. Nilai yang mungkin adalah "true" dan "false". Nilai defaultnya adalah "false". |
| ID Pengguna | DBPROP_AUTH_USERID | Nama masuk SQL Server. |
| ID Stasiun Kerja | SSPROP_INIT_WSID | Pengidentifikasi stasiun kerja. |
Catatan Dalam string koneksi, properti "Kata Sandi Lama" mengatur SSPROP_AUTH_OLD_PASSWORD, yang merupakan kata sandi saat ini (mungkin kedaluwarsa) yang tidak tersedia melalui properti string penyedia.
Baca juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk