SQLBrowseConnect

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

SQLBrowse Koneksi menggunakan kata kunci yang dapat dikategorikan ke dalam tiga tingkat informasi koneksi. Untuk setiap kata kunci, tabel berikut menunjukkan apakah daftar nilai yang valid dikembalikan dan apakah kata kunci bersifat opsional.

Level 1

Kata kunci	Daftar dikembalikan?	Opsional?	Deskripsi
DSN	T/A	No	Nama sumber data yang dikembalikan oleh SQLDataSources. Kata kunci DSN tidak dapat digunakan jika kata kunci DRIVER digunakan.
DRIVER	T/A	No	Nama driver ODBC Klien Asli SQL Server adalah {SQL Server Native Client 11}. Kata kunci DRIVER tidak dapat digunakan jika kata kunci DSN digunakan.

Level 2

Kata kunci	Daftar dikembalikan?	Opsional?	Deskripsi
SERVER	Ya	Tidak	Nama server di jaringan tempat sumber data berada. Istilah "(lokal)" dapat dimasukkan sebagai server, dalam hal ini salinan lokal SQL Server dapat digunakan, bahkan ketika ini adalah versi non-jaringan.
UID	Tidak	Ya	ID masuk pengguna.
PWD	No	Ya (tergantung pada pengguna)	Kata sandi yang ditentukan pengguna.
APLIKASI	Tidak	Ya	Nama aplikasi yang memanggil SQLBrowse Koneksi.
WSID	Tidak	Ya	ID Stasiun Kerja. Biasanya, ini adalah nama jaringan komputer tempat aplikasi berjalan.

Level 3

Kata kunci	Daftar dikembalikan?	Opsional?	Deskripsi
DATABASE	Ya	Ya	Nama database SQL Server.
BAHASA	Ya	Ya	Bahasa nasional yang digunakan oleh SQL Server.

SQLBrowse Koneksi mengabaikan nilai kata kunci DATABASE dan LANGUAGE yang disimpan dalam definisi sumber data ODBC. Jika database atau bahasa yang ditentukan dalam string koneksi diteruskan ke SQLBrowse Koneksi tidak valid, SQLBrowse Koneksi mengembalikan SQL_NEED_DATA dan atribut koneksi tingkat 3.

Atribut berikut, yang diatur dengan memanggil SQLSet Koneksi Attr, menentukan kumpulan hasil yang dikembalikan oleh SQLBrowse Koneksi.

Atribut	Deskripsi
SQL_COPT_SS_BROWSE_CONNECT	Jika diatur ke SQL_MORE_INFO_YES, SQLBrowse Koneksi mengembalikan string properti server yang diperluas. Berikut ini adalah contoh string yang diperluas yang dikembalikan oleh SQLBrowse Koneksi: ServerName\InstanceName;Clustered:No;Version:8.00.131 Dalam string ini, titik koma memisahkan berbagai informasi tentang server. Gunakan koma untuk memisahkan instans server yang berbeda.
SQL_COPT_SS_BROWSE_SERVER	Jika nama server ditentukan, SQLBrowse Koneksi akan mengembalikan informasi untuk server yang ditentukan. Jika SQL_COPT_SS_BROWSE_SERVER diatur ke NULL, SQLBrowse Koneksi mengembalikan informasi untuk semua server di domain. Perhatikan bahwa karena masalah jaringan, SQLBrowse Koneksi mungkin tidak menerima respons tepat waktu dari semua server. Oleh karena itu, daftar server yang dikembalikan dapat bervariasi untuk setiap permintaan.
SQL_COPT_SS_BROWSE_CACHE_DATA	Saat atribut SQL_COPT_SS_BROWSE_CACHE_DATA diatur ke SQL_CACHE_DATA_YES, Anda dapat mengambil data dalam gugus saat panjang buffer tidak cukup besar untuk menahan hasilnya. Panjang ini ditentukan dalam argumen BufferLength ke SQLBrowse Koneksi. SQL_NEED_DATA dikembalikan saat lebih banyak data tersedia. SQL_SUCCESS dikembalikan ketika tidak ada lagi data yang akan diambil. Defaultnya adalah SQL_CACHE_DATA_NO.

Dukungan SQLBrowse Koneksi untuk Ketersediaan Tinggi, Pemulihan Bencana

Untuk informasi selengkapnya tentang menggunakan SQLBrowse Koneksi untuk menyambungkan ke kluster grup ketersediaan AlwaysOn, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana.

Dukungan SQLBrowse Koneksi untuk Nama Perwakilan Layanan (SPN)

Saat koneksi dibuka, SQL Server Native Client mengatur SQL_COPT_SS_MUTUALLY_AUTHENTICATED dan SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ke metode autentikasi yang digunakan untuk membuka koneksi.

Untuk informasi selengkapnya tentang SPN, lihat Nama Perwakilan Layanan (SPN) di Koneksi ion Klien (ODBC).

Ubah Riwayat

Konten yang diperbarui
SQL_COPT_SS_BROWSE_CACHE_DATA terdokumen.

Lihat Juga

Fungsi SQLBrowse Koneksi
Detail Implementasi ODBC API