SQLGetConnectAttr

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

Driver ODBC SQL Server Native Client mendefinisikan atribut koneksi khusus driver. Beberapa atribut tersedia untuk SQLGetConnectAttr, dan fungsi ini digunakan untuk melaporkan pengaturannya saat ini. Nilai yang dilaporkan untuk atribut ini tidak dijamin sampai setelah koneksi dibuat atau atribut telah diatur menggunakan SQLSetConnectAttr.

Topik ini mencantumkan atribut baca-saja. Untuk informasi tentang atribut koneksi khusus driver ODBC SQL Server Native Client lainnya, lihat SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

Atribut SQL_COPT_SS_CONNECTION_DEAD melaporkan status koneksi ke server. Driver meminta jaringan untuk status koneksi saat ini.

Catatan

Atribut koneksi ODBC standar SQL_ATTR_CONNECTION_DEAD mengembalikan status koneksi terbaru. Ini mungkin bukan status koneksi saat ini.

Nilai	Deskripsi
SQL_CD_TRUE	Sambungan ke server telah hilang.
SQL_CD_FALSE	Koneksi terbuka dan tersedia untuk pemrosesan pernyataan.

SQL_COPT_SS_CLIENT_CONNECTION_ID

Atribut SQL_COPT_SS_CLIENT_CONNECTION_ID mengambil ID koneksi klien, yang kemudian dapat digunakan untuk menemukan:

• Informasi diagnostik di log XEvents, saat diaktifkan.

• Informasi kesalahan koneksi dalam buffer cincin koneksi.

• Informasi diagnostik dalam log pelacakan akses data, saat diaktifkan.

Untuk informasi selengkapnya, lihat Mengakses Informasi Diagnostik di Log Peristiwa yang Diperluas.

Nilai	Deskripsi
SQL_ERROR	Sambungan gagal.
SQL_SUCCESS	Koneksi berhasil. ID koneksi klien akan ditemukan di buffer output.

SQL_COPT_SS_PERF_DATA

Atribut SQL_COPT_SS_PERF_DATA mengembalikan pointer ke struktur SQLPERF yang berisi statistik performa driver saat ini. SQLGetConnectAttr akan mengembalikan NULL jika pengelogan performa tidak diaktifkan. Statistik dalam struktur SQLPERF tidak diperbarui secara dinamis oleh driver. Panggil SQLGetConnectAttr setiap kali statistik performa perlu disegarkan.

Nilai	Deskripsi
NULL	Pengelogan performa tidak diaktifkan.
Nilai lainnya	Penunjuk ke struktur SQLPERF.

SQL_COPT_SS_PERF_QUERY

Atribut SQL_COPT_SS_PERF_QUERY mengembalikan TRUE jika pengelogan kueri yang berjalan lama diaktifkan. Permintaan mengembalikan FALSE jika pengelogan kueri tidak aktif.

SQL_COPT_SS_USER_DATA

Atribut SQL_COPT_SS_USER_DATA mengambil penunjuk data pengguna. Data pengguna disimpan dalam memori milik klien dan direkam per koneksi. Jika penunjuk data pengguna belum diatur, SQL_UD_NOTSET, penunjuk NULL, dikembalikan.

Nilai	Deskripsi
SQL_UD_NOTSET	Tidak ada penunjuk data pengguna yang diatur.
Nilai lainnya	Penunjuk ke data pengguna.

Dukungan SQLGetConnectAttr untuk Nama Perwakilan Layanan (SPN)

SQLGetConnectAttr dapat digunakan untuk mengkueri nilai atribut koneksi baru SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED, dan SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption juga dapat digunakan untuk mengkueri nilai-nilai ini.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD hanya tersedia untuk sambungan terbuka yang menggunakan Autentikasi Windows.

Jika SQL_COPT_SS_SERVER_SPN atau SQL_COPT_SS_FAILOVER_PARTNER belum ditetapkan, nilai default (string kosong) dikembalikan.

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

Lihat Juga

Fungsi SQLGetConnectAttr
Detail Implementasi ODBC API
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)