SQLSetConnectAttr
Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform 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 di 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