SQLBrowseConnect

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

SQLBrowseConnect 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?	Fakultatif?	Deskripsi
DSN	T/A	No	Nama sumber data yang dikembalikan oleh SQLDataSources. Kata kunci DSN tidak dapat digunakan jika kata kunci DRIVER digunakan.
PENGEMUDI	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?	Fakultatif?	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 SQLBrowseConnect.
WSID	Tidak	Ya	ID Stasiun Kerja. Biasanya, ini adalah nama jaringan komputer tempat aplikasi berjalan.

Level 3

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

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

Atribut berikut, yang diatur dengan memanggil SQLSetConnectAttr, menentukan kumpulan hasil yang dikembalikan oleh SQLBrowseConnect.

Atribut	Deskripsi
SQL_COPT_SS_BROWSE_CONNECT	Jika diatur ke SQL_MORE_INFO_YES, SQLBrowseConnect mengembalikan string properti server yang diperluas. Berikut ini adalah contoh string yang diperluas yang dikembalikan oleh SQLBrowseConnect: 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, SQLBrowseConnect akan mengembalikan informasi untuk server yang ditentukan. Jika SQL_COPT_SS_BROWSE_SERVER diatur ke NULL, SQLBrowseConnect mengembalikan informasi untuk semua server di domain. Perhatikan bahwa karena masalah jaringan, SQLBrowseConnect 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 SQLBrowseConnect. 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 SQLBrowseConnect untuk Ketersediaan Tinggi, Pemulihan Bencana

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

Dukungan SQLBrowseConnect 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 Klien (ODBC).

Ubah Riwayat

Konten yang diperbarui
SQL_COPT_SS_BROWSE_CACHE_DATA terdokumen.

Lihat Juga

Fungsi SQLBrowseConnect
Detail Implementasi ODBC API