SQLSetConnectAttr

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

Driver ODBC Klien Asli SQL Server mengabaikan pengaturan SQL_ATTR_CONNECTION_TIMEOUT.

SQL_ATTR_TRANSLATE_LIB juga diabaikan; menentukan pustaka terjemahan lain tidak didukung. Untuk memungkinkan aplikasi dengan mudah di-port untuk menggunakan driver Microsoft ODBC untuk SQL Server, nilai apa pun yang diatur dengan SQL_ATTR_TRANSLATE_LIB akan disalin ke dalam dan keluar dari buffer di Driver Manager.

Driver ODBC Klien Asli SQL Server menerapkan isolasi transaksi baca yang dapat diulang sebagai dapat diserialisasikan.

SQL Server 2005 (9.x) memperkenalkan dukungan untuk atribut isolasi transaksi baru, SQL_COPT_SS_TXN_ISOLATION. Mengatur SQL_COPT_SS_TXN_ISOLATION ke SQL_TXN_SS_SNAPSHOT menunjukkan bahwa transaksi akan terjadi di bawah tingkat isolasi rekam jepret.

Catatan

SQL_ATTR_TXN_ISOLATION dapat digunakan untuk mengatur semua tingkat isolasi lainnya kecuali untuk SQL_TXN_SS_SNAPSHOT. Jika Anda ingin menggunakan isolasi rekam jepret, Anda harus mengatur SQL_TXN_SS_SNAPSHOT melalui SQL_COPT_SS_TXN_ISOLATION. Namun, Anda dapat mengambil tingkat isolasi dengan menggunakan SQL_ATTR_TXN_ISOLATION atau SQL_COPT_SS_TXN_ISOLATION.

Mempromosikan atribut pernyataan ODBC ke atribut koneksi dapat memiliki konsekuensi yang tidak diinginkan. Atribut pernyataan yang meminta kursor server untuk pemrosesan kumpulan hasil dapat dipromosikan ke koneksi. Misalnya, mengatur atribut pernyataan ODBC SQL_ATTR_CONCURRENCY ke nilai yang lebih ketat daripada SQL_CONCUR_READ_ONLY default mengarahkan driver untuk menggunakan kursor dinamis untuk semua pernyataan yang dikirimkan pada koneksi. Menjalankan fungsi katalog ODBC pada pernyataan pada koneksi mengembalikan SQL_SUCCESS_WITH_INFO dan catatan diagnostik yang menunjukkan bahwa perilaku kursor telah diubah menjadi baca-saja. Mencoba menjalankan pernyataan Transact-SQL SELECT yang berisi klausa COMPUTE pada koneksi yang sama gagal.

Driver ODBC Klien Asli SQL Server mendukung sejumlah ekstensi khusus driver ke atribut koneksi ODBC yang ditentukan dalam sqlncli.h. Driver ODBC Klien Asli SQL Server mungkin mengharuskan atribut diatur sebelum koneksi, atau mungkin mengabaikan atribut jika sudah diatur. Tabel berikut ini mencantumkan pembatasan.

Atribut SQL Server	Atur sebelum atau sesudah koneksi ke server
SQL_COPT_SS_ANSI_NPW	Sebelumnya
SQL_COPT_SS_APPLICATION_INTENT	Sebelumnya
SQL_COPT_SS_ATTACHDBFILENAME	Sebelumnya
SQL_COPT_SS_BCP	Sebelumnya
SQL_COPT_SS_BROWSE_CONNECT	Sebelumnya
SQL_COPT_SS_BROWSE_SERVER	Sebelumnya
SQL_COPT_SS_CONCAT_NULL	Sebelumnya
SQL_COPT_SS_CONNECTION_DEAD	Sesudahnya
SQL_COPT_SS_ENCRYPT	Sebelumnya
SQL_COPT_SS_ENLIST_IN_DTC	Sesudahnya
SQL_COPT_SS_ENLIST_IN_XA	Sesudahnya
SQL_COPT_SS_FALLBACK_CONNECT	Sebelumnya
SQL_COPT_SS_FAILOVER_PARTNER	Sebelumnya
SQL_COPT_SS_INTEGRATED_SECURITY	Sebelumnya
SQL_COPT_SS_MARS_ENABLED	Sebelumnya
SQL_COPT_SS_MULTISUBNET_FAILOVER	Sebelumnya
SQL_COPT_SS_OLDPWD	Sebelumnya
SQL_COPT_SS_PERF_DATA	Sesudahnya
SQL_COPT_SS_PERF_DATA_LOG	Sesudahnya
SQL_COPT_SS_PERF_DATA_LOG_NOW	Sesudahnya
SQL_COPT_SS_PERF_QUERY	Sesudahnya
SQL_COPT_SS_PERF_QUERY_INTERVAL	Sesudahnya
SQL_COPT_SS_PERF_QUERY_LOG	Sesudahnya
SQL_COPT_SS_PRESERVE_CURSORS	Sebelumnya
SQL_COPT_SS_QUOTED_IDENT	Baik
SQL_COPT_SS_TRANSLATE	Baik
SQL_COPT_SS_TRUST_SERVER_CERTIFICATE	Sebelumnya
SQL_COPT_SS_TXN_ISOLATION	Baik
SQL_COPT_SS_USE_PROC_FOR_PREP	Baik
SQL_COPT_SS_USER_DATA	Baik
SQL_COPT_SS_WARN_ON_CP_ERROR	Sebelumnya

Menggunakan atribut pra-koneksi dan perintah Transact-SQL yang setara untuk sesi, database, atau status SQL Server yang sama dapat menghasilkan perilaku yang tidak terduga. Contohnya,

SQLSetConnectAttr(SQL_COPT_SS_QUOTED_IDENT, SQL_QI_ON) // turn ON via attribute  
SQLDriverConnect(...);  
SQLExecDirect("SET QUOTED_IDENTIFIER OFF") // turn OFF via Transact-SQL  
SQLSetConnectAttr(SQL_ATTR_CURRENT_CATALOG, ...) // restores to pre-connect attribute value  

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW memungkinkan atau menonaktifkan penggunaan penanganan ISO NULL dalam perbandingan dan perangkaian, padding jenis data karakter, dan peringatan. Untuk informasi selengkapnya, lihat MENGATUR ANSI_NULLS, MENGATUR ANSI_PADDING, MENGATUR ANSI_WARNINGS, dan MENGATUR CONCAT_NULL_YIELDS_NULL.

Nilai	Deskripsi
SQL_AD_ON	Default. Koneksi menggunakan perilaku default ANSI untuk menangani perbandingan NULL, padding, peringatan, dan perangkaian NULL.
SQL_AD_OFF	Koneksi menggunakan penanganan NULL yang ditentukan SQL Server, padding jenis data karakter, dan peringatan.

Jika Anda menggunakan pengumpulan koneksi, SQL_COPT_SS_ANSI_NPW harus diatur dalam string koneksi, bukan dengan SQLSetConnectAttr. Setelah koneksi dibuat, setiap upaya untuk mengubah atribut ini akan gagal secara diam-diam saat pengumpulan koneksi digunakan.

SQL_COPT_SS_APPLICATION_INTENT

Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah Readonly dan ReadWrite. Contohnya:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_APPLICATION_INTENT, TEXT("Readonly"), SQL_NTS)  

Defaultnya adalah ReadWrite. Untuk informasi selengkapnya tentang dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn AGs, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME menentukan nama file utama database yang dapat dilampirkan. Database ini dilampirkan dan menjadi database default untuk koneksi. Untuk menggunakan SQL_COPT_SS_ATTACHDBFILENAME Anda harus menentukan nama database sebagai nilai atribut koneksi SQL_ATTR_CURRENT_CATALOG atau dalam DATABASE = parameter SQLDriverConnect. Jika database sebelumnya dilampirkan, SQL Server tidak akan memasangnya kembali.

Nilai	Deskripsi
SQLPOINTER ke string karakter	String berisi nama file utama untuk dilampirkan database. Sertakan nama jalur lengkap file.

SQL_COPT_SS_BCP

SQL_COPT_SS_BCP mengaktifkan fungsi penyalinan massal pada koneksi. Untuk informasi selengkapnya, lihat Fungsi Salin Massal.

Nilai	Deskripsi
SQL_BCP_OFF	Default. Fungsi penyalinan massal tidak tersedia pada koneksi.
SQL_BCP_ON	Fungsi penyalinan massal tersedia pada koneksi.

SQL_COPT_SS_BROWSE_CONNECT

Atribut ini digunakan untuk menyesuaikan kumpulan hasil yang dikembalikan oleh SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT mengaktifkan atau menonaktifkan pengembalian informasi tambahan dari instans SQL Server yang dijumlahkan. Ini dapat mencakup informasi seperti apakah server adalah kluster, nama instans yang berbeda, dan nomor versi.

Nilai	Deskripsi
SQL_MORE_INFO_NO	Default. Mengembalikan daftar server.
SQL_MORE_INFO_YES	SQLBrowseConnect mengembalikan string properti server yang diperluas.

SQL_COPT_SS_BROWSE_SERVER

Atribut ini digunakan untuk menyesuaikan kumpulan hasil yang dikembalikan oleh SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER menentukan nama server tempat SQLBrowseConnect mengembalikan informasi.

Nilai	Deskripsi
nama komputer	SQLBrowseConnect mengembalikan daftar instans SQL Server di komputer yang ditentukan. Garis miring terbalik ganda (\\) tidak boleh digunakan untuk nama server (misalnya, alih-alih \\MyServer, MyServer harus digunakan).
NULL	Default. SQLBrowseConnect mengembalikan informasi untuk semua server di domain.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL mengaktifkan atau menonaktifkan penggunaan penanganan ISO NULL saat menggabungkan string. Untuk informasi selengkapnya, lihat MENGATUR CONCAT_NULL_YIELDS_NULL.

Nilai	Deskripsi
SQL_CN_ON	Default. Koneksi menggunakan perilaku default ISO untuk menangani nilai NULL saat menggabungkan string.
SQL_CN_OFF	Koneksi menggunakan perilaku yang ditentukan SQL Server untuk menangani nilai NULL saat menggabungkan string.

SQL_COPT_SS_ENCRYPT

Mengontrol enkripsi untuk koneksi.

Enkripsi menggunakan sertifikat pada server. Ini harus diverifikasi oleh otoritas sertifikat, kecuali atribut koneksi SQL_COPT_SS_TRUST_SERVER_CERTIFICATE diatur ke SQL_TRUST_SERVER_CERTIFICATE_YES atau string koneksi berisi "TrustServerCertificate=yes". Jika salah satu kondisi ini benar, sertifikat yang dihasilkan dan ditandatangani oleh server dapat digunakan untuk mengenkripsi koneksi jika tidak ada sertifikat di server.

Nilai	Deskripsi
SQL_EN_ON	Koneksi akan dienkripsi.
SQL_EN_OFF	Koneksi tidak akan dienkripsi. Ini adalah default.

SQL_COPT_SS_ENLIST_IN_DTC

Klien memanggil metode Microsoft Distributed Transaction Coordinator (MS DTC) OLE DB ITransactionDispenser::BeginTransaction untuk memulai transaksi MS DTC dan membuat objek transaksi MS DTC yang mewakili transaksi. Aplikasi kemudian memanggil SQLSetConnectAttr dengan opsi SQL_COPT_SS_ENLIST_IN_DTC untuk mengaitkan objek transaksi dengan koneksi ODBC. Semua aktivitas database terkait akan dilakukan di bawah perlindungan transaksi MS DTC. Aplikasi memanggil SQLSetConnectAttr dengan SQL_DTC_DONE untuk mengakhiri asosiasi DTC koneksi.

Nilai	Deskripsi
Objek DTC*	Objek transaksi MS DTC OLE yang menentukan transaksi yang akan diekspor ke SQL Server.
SQL_DTC_DONE	Memisahkan akhir transaksi DTC.

SQL_COPT_SS_ENLIST_IN_XA

Untuk memulai transaksi XA dengan Prosesor Transaksi (TP) yang mematuhi XA, klien memanggil fungsi tx_begin Grup Terbuka. Aplikasi kemudian memanggil SQLSetConnectAttr dengan parameter SQL_COPT_SS_ENLIST_IN_XA TRUE untuk mengaitkan transaksi XA dengan koneksi ODBC. Semua aktivitas database terkait akan dilakukan di bawah perlindungan transaksi XA. Untuk mengakhiri asosiasi XA dengan koneksi ODBC, klien harus memanggil SQLSetConnectAttr dengan parameter SQL_COPT_SS_ENLIST_IN_XA FALSE. Untuk informasi selengkapnya, lihat dokumentasi Koordinator Transaksi Terdistribusi Microsoft.

SQL_COPT_SS_FALLBACK_CONNECT

Atribut ini tidak lagi didukung.

SQL_COPT_SS_FAILOVER_PARTNER

Digunakan untuk menentukan atau mengambil nama mitra failover yang digunakan untuk pencerminan database di SQL Server, dan ini adalah string karakter null yang dihentikan yang harus diatur sebelum koneksi ke SQL Server awalnya dibuat.

Setelah membuat koneksi, aplikasi dapat mengkueri atribut ini menggunakan SQLGetConnectAttr untuk menentukan identitas mitra failover. Jika server utama tidak memiliki mitra failover, properti ini akan mengembalikan string kosong. Ini memungkinkan aplikasi pintar untuk menyimpan server cadangan yang terakhir ditentukan, tetapi aplikasi tersebut harus mengetahui bahwa informasi hanya diperbarui ketika koneksi pertama kali dibuat, atau diatur ulang, jika dikumpulkan, dan dapat menjadi kedaluarsa untuk koneksi jangka panjang.

Untuk informasi selengkapnya, lihat Menggunakan Pencerminan Database.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY memaksa penggunaan Autentikasi Windows untuk validasi akses pada login server. Ketika Autentikasi Windows digunakan, driver mengabaikan nilai pengidentifikasi pengguna dan kata sandi yang disediakan sebagai bagian dari pemrosesan SQLConnect, SQLDriverConnect, atau SQLBrowseConnect .

Nilai	Deskripsi
SQL_IS_OFF	Default. Autentikasi SQL Server digunakan untuk memvalidasi pengidentifikasi pengguna dan kata sandi saat masuk.
SQL_IS_ON	Mode Autentikasi Windows digunakan untuk memvalidasi hak akses pengguna ke SQL Server.

SQL_COPT_SS_MARS_ENABLED

Atribut ini mengaktifkan atau menonaktifkan Beberapa Set Hasil Aktif (MARS). Secara default, MARS dinonaktifkan. Atribut ini harus diatur sebelum membuat koneksi ke SQL Server. Setelah koneksi SQL Server dibuka, MARS akan tetap diaktifkan atau dinonaktifkan selama masa pakai koneksi.

Nilai	Deskripsi
SQL_MARS_ENABLED_NO	Default. Beberapa Set Hasil Aktif (MARS) dinonaktifkan.
SQL_MARS_ENABLED_YES	MARS diaktifkan.

Untuk informasi selengkapnya tentang MARS, lihat Menggunakan Beberapa Set Hasil Aktif (MARS).

SQL_COPT_SS_MULTISUBNET_FAILOVER

Jika aplikasi Anda tersambung ke grup ketersediaan AlwaysOn grup ketersediaan (AG) pada subnet yang berbeda, properti koneksi ini mengonfigurasi SQL Server Native Client untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Contohnya:

SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBNET_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)  

Untuk informasi selengkapnya tentang dukungan Klien Asli SQL Server untuk grup ketersediaan AlwaysOn AGs, lihat Dukungan Klien Asli SQL Server untuk Ketersediaan Tinggi, Pemulihan Bencana.

Nilai	Deskripsi
SQL_IS_ON	SQL Server Native Client menyediakan koneksi ulang yang lebih cepat jika ada failover.
SQL_IS_OFF	SQL Server Native Client tidak akan memberikan koneksi ulang yang lebih cepat jika ada failover.

SQL_COPT_SS_OLDPWD

Kedaluwarsa kata sandi untuk Autentikasi SQL Server diperkenalkan di SQL Server 2005 (9.x). Atribut SQL_COPT_SS_OLDPWD telah ditambahkan untuk memungkinkan klien menyediakan kata sandi lama dan baru untuk koneksi. Ketika properti ini diatur, penyedia tidak akan menggunakan kumpulan koneksi untuk koneksi pertama atau untuk koneksi berikutnya, karena string koneksi akan berisi "kata sandi lama" yang sekarang telah berubah.

Untuk informasi selengkapnya, lihat Mengubah Kata Sandi Secara Terprogram.

Nilai	Deskripsi
SQL_COPT_SS_OLD_PASSWORD	SQLPOINTER ke string karakter yang berisi kata sandi lama. Nilai ini hanya-tulis, dan harus diatur sebelum koneksi ke server.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA memulai atau menghentikan pengelogan data performa. Nama file log data harus diatur sebelum memulai pengelogan data. Lihat SQL_COPT_SS_PERF_DATA_LOG di bawah ini.

Nilai	Deskripsi
SQL_PERF_START	Memulai data performa pengambilan sampel driver.
SQL_PERF_STOP	Menghentikan penghitung dari pengambilan sampel data performa.

Untuk informasi selengkapnya, lihat SQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG menetapkan nama file log yang digunakan untuk merekam data performa. Nama file log adalah ansi atau Unicode, string null-terminated tergantung pada kompilasi aplikasi. Argumen StringLength harus SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW menginstruksikan driver untuk menulis entri log statistik ke disk. Argumen StringLength harus SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY memulai atau menghentikan pengelogan untuk kueri yang berjalan lama. Nama file log kueri harus disediakan sebelum memulai pengelogan. Aplikasi dapat menentukan "jangka panjang" dengan mengatur interval untuk pengelogan.

Nilai	Deskripsi
SQL_PERF_START	Mulai pengelogan kueri yang berjalan lama.
SQL_PERF_STOP	Menghentikan pengelogan kueri yang berjalan lama.

Untuk informasi selengkapnya, lihat SQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL mengatur ambang pengelogan kueri dalam milidetik. Kueri yang tidak diselesaikan dalam ambang direkam dalam file log kueri yang berjalan lama. Tidak ada batas atas pada ambang kueri. Nilai ambang kueri nol menyebabkan pengelogan semua kueri.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG menetapkan nama file log untuk merekam data kueri yang berjalan lama. Nama file log adalah ansi atau Unicode, string null-terminated tergantung pada kompilasi aplikasi. Argumen StringLength harus SQL_NTS atau panjang string dalam byte.

SQL_COPT_SS_PRESERVE_CURSORS

Atribut ini memungkinkan Anda untuk mengkueri dan mengatur apakah koneksi akan mempertahankan kursor saat Anda menerapkan/memutar kembali transaksi atau tidak. Pengaturannya SQL_PC_ON atau SQL_PC_OFF. Nilai defaultnya adalah SQL_PC_OFF. Pengaturan ini mengontrol apakah driver akan menutup kursor untuk Anda saat Anda memanggil SQLEndTran (atau SQLTransact).

Nilai	Deskripsi
SQL_PC_OFF	Default. Kursor ditutup ketika transaksi dilakukan atau digulung balik menggunakan SQLEndTran.
SQL_PC_ON	Kursor tidak ditutup ketika transaksi dilakukan atau digulung balik menggunakan SQLEndTran, kecuali saat menggunakan kursor statis atau set kunci dalam mode asinkron. Jika pembatalan dikeluarkan saat populasi kursor tidak selesai, kursor ditutup.

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT memungkinkan pengidentifikasi yang dikutip dalam pernyataan ODBC dan Transact-SQL yang dikirimkan pada koneksi. Dengan menyediakan pengidentifikasi yang dikutip, driver ODBC SQL Server Native Client memungkinkan nama objek yang tidak valid seperti "Tabel Saya", yang berisi karakter spasi dalam pengidentifikasi. Untuk informasi selengkapnya, lihat MENGATUR QUOTED_IDENTIFIER.

Nilai	Deskripsi
SQL_QI_OFF	Koneksi SQL Server tidak mengizinkan pengidentifikasi yang dikutip dalam Transact-SQL yang dikirimkan.
SQL_QI_ON	Default. Koneksi memungkinkan pengidentifikasi yang dikutip dalam Transact-SQL yang dikirimkan.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE menyebabkan driver menerjemahkan karakter antara halaman kode klien dan server saat data MBCS dipertukarkan. Atribut hanya memengaruhi data yang disimpan di kolom karakter, varchar, dan teks SQL Server.

Nilai	Deskripsi
SQL_XL_OFF	Driver tidak menerjemahkan karakter dari satu halaman kode ke halaman lain dalam data karakter yang dipertukarkan antara klien dan server.
SQL_XL_ON	Default. Driver menerjemahkan karakter dari satu halaman kode ke halaman lain dalam data karakter yang dipertukarkan antara klien dan server. Driver secara otomatis mengonfigurasi terjemahan karakter, menentukan halaman kode yang diinstal pada server dan yang digunakan oleh klien.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE menyebabkan driver mengaktifkan atau menonaktifkan validasi sertifikat saat menggunakan enkripsi. Atribut ini adalah nilai baca/tulis, tetapi mengaturnya setelah koneksi dibuat tidak berpengaruh.

Aplikasi klien dapat mengkueri properti ini setelah koneksi dibuka untuk menentukan pengaturan enkripsi dan validasi aktual yang digunakan.

Nilai	Deskripsi
SQL_TRUST_SERVER_CERTIFICATE_NO	Default. Enkripsi tanpa validasi sertifikat tidak diaktifkan.
SQL_TRUST_SERVER_CERTIFICATE_YES	Enkripsi tanpa validasi sertifikat diaktifkan.

SQL_COPT_SS_TXN_ISOLATION

SQL_COPT_SS_TXN_ISOLATION mengatur atribut isolasi rekam jepret khusus SQL Server. Isolasi rekam jepret tidak dapat diatur menggunakan SQL_ATTR_TXN_ISOLATION karena nilainya spesifik untuk SQL Server. Namun, dapat diambil menggunakan SQL_ATTR_TXN_ISOLATION atau SQL_COPT_SS_TXN_ISOLATION.

Nilai	Deskripsi
SQL_TXN_SS_SNAPSHOT	Menunjukkan bahwa dari satu transaksi Anda tidak dapat melihat perubahan yang dilakukan dalam transaksi lain dan Anda tidak dapat melihat perubahan bahkan saat kueri ulang.

Untuk informasi selengkapnya tentang isolasi rekam jepret, lihat Bekerja dengan Isolasi Rekam Jepret.

SQL_COPT_SS_USE_PROC_FOR_PREP

Atribut ini tidak lagi didukung.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA mengatur penunjuk data pengguna. Data pengguna adalah memori milik klien yang direkam per koneksi.

Untuk informasi selengkapnya, lihat SQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Atribut ini menentukan apakah Anda akan mendapatkan peringatan jika ada kehilangan data selama konversi halaman kode. Ini hanya berlaku untuk data yang berasal dari server.

Nilai	Deskripsi
SQL_WARN_YES	Hasilkan peringatan ketika kehilangan data ditemui selama konversi codepage.
SQL_WARN_NO	(Default) Jangan menghasilkan peringatan ketika kehilangan data ditemui selama konversi codepage.

Dukungan SQLSetConnectAttr untuk Nama Perwakilan Layanan (SPN)

SQLSetConnectAttr dapat digunakan untuk mengatur nilai atribut koneksi baru SQL_COPT_SS_SERVER_SPN dan SQL_COPT_SS_FAILOVER_PARTNER_SPN. Atribut ini tidak dapat diatur ketika koneksi terbuka; jika Anda mencoba mengatur atribut ini saat koneksi terbuka, kesalahan HY011 dikembalikan dengan pesan "Operasi tidak valid saat ini". (SQLSetConnectOption juga dapat digunakan untuk mengatur nilai-nilai ini.)

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

SQL_COPT_SS_CONNECTION_DEAD

Ini adalah atribut baca-saja.

Untuk informasi selengkapnya tentang SQL_COPT_SS_CONNECTION_DEAD, lihat SQLGetConnectAttr dan Menyambungkan ke Sumber Data (ODBC).

Contoh

Contoh ini mencatat data performa.

SQLPERF*     pSQLPERF;  
SQLINTEGER   nValue;  
  
// See if you are already logging. SQLPERF* will be NULL if not.  
SQLGetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA, &pSQLPERF,  
    sizeof(SQLPERF*), &nValue);  
  
if (pSQLPERF == NULL)  
    {  
    // Set the performance log file name.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG,  
        (SQLPOINTER) "\\My LogDirectory\\MyServerLog.txt", SQL_NTS);  
  
    // Start logging...  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
        (SQLPOINTER) SQL_PERF_START, SQL_IS_INTEGER);  
    }  
else  
    {  
    // Take a snapshot now so that your performance statistics are discernible.  
    SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
    }  
  
    // ...perform some action...  
  
// ...take a performance data snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
    // ...perform more actions...  
  
// ...take another snapshot...  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);  
  
// ...and disable logging.  
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,  
    (SQLPOINTER) SQL_PERF_STOP, SQL_IS_INTEGER);  
  
// Continue on...  

Lihat Juga

Fungsi SQLSetConnectAttr
Detail Implementasi ODBC API
Fungsi Salin Massal
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
Fungsi SQLPrepare
SQLGetInfo