Bagikan melalui


Menggunakan Kata Kunci String Koneksi dengan SQL Server Native Client

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

Penting

SQL Server Native Client (SNAC) tidak dikirim dengan:

  • SQL Server 2022 (16.x) dan versi yang lebih baru
  • SQL Server Management Studio 19 dan versi yang lebih baru

SQL Server Native Client (SQLNCLI atau SQLNCLI11) dan Penyedia Microsoft OLE DB warisan untuk SQL Server (SQLOLEDB) tidak direkomendasikan untuk pengembangan aplikasi baru.

Untuk proyek baru, gunakan salah satu driver berikut:

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 apa pun 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 untuk 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 Pengelola Konfigurasi SQL Server.

Nilai Alamat lebih diutamakan daripada nilai yang diteruskan ke Server di 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 dalam Pengelola Konfigurasi SQL Server.

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=ReadOnly

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 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.mdf

Database 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=Yes

Untuk informasi selengkapnya tentang dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana.
Jaring 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_IDENTIFIER diatur AKTIF untuk koneksi, SQL Server menggunakan aturan ISO mengenai penggunaan tanda kutip dalam pernyataan SQL. Jika tidak, QUOTED_IDENTIFIER 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 Pengelola Konfigurasi SQL Server.

Sintaks lengkap untuk kata kunci Server adalah sebagai berikut:

Server=[protokol:]Server[,port]

protokol dapat berupa tcp (TCP/IP), lpc (memori bersama), atau np (pipa bernama).

Berikut ini adalah contoh menentukan pipa bernama:

np:\\.\pipe\MSSQL$MYINST01\sql\query

Baris 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 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 di 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 di IDataInitialize:GetDataSource string koneksi s, karena perilaku ini mungkin tidak dipertahankan dalam rilis mendatang.

Catatan

String koneksi melewati IDataInitialize::GetDataSource dikonversi menjadi properti dan diterapkan melalui IDBProperties::SetProperties. Jika layanan komponen menemukan deskripsi properti di IDBProperties::GetPropertyInfo, properti ini akan diterapkan sebagai properti yang berdiri sendiri. Jika tidak, itu akan diterapkan melalui properti DBPROP_PROVIDERSTRING. Misalnya, jika Anda menentukan string koneksi Sumber Data=server1; Server=server2, Sumber Data akan diatur sebagai properti, tetapi Server akan masuk ke string penyedia.

Jika Anda menentukan beberapa instans properti khusus penyedia yang sama, nilai pertama properti pertama akan digunakan.

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".
Jaring SSPROP_INIT_NETWORKLIBRARY Sinonim untuk "Jaringan".
Jaringan SSPROP_INIT_NETWORKLIBRARY Pustaka jaringan yang digunakan untuk membuat koneksi ke instans SQL Server di organisasi.
Pustaka Jaringan SSPROP_INIT_NETWORKLIBRARY Sinonim untuk "Jaringan".
Ukuran Paket SSPROP_INIT_PACKETSIZE Ukuran paket 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" diatur 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 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 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" 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 SQL Server Native Client