Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:
SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
Penting
Fitur ini akan dihapus dalam versi Windows yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Microsoft merekomendasikan penggunaan fungsi kursor driver.
Pustaka kursor ODBC menyediakan dukungan kursor yang dapat digulir untuk driver ODBC 2.x yang hanya mendukung kursor hanya maju. Saat Anda mengaktifkan pustaka kursor untuk koneksi, Driver Manager mencegat panggilan fungsi dan merutekannya melalui pustaka kursor alih-alih langsung ke driver. Pustaka kursor menjalankan fungsi itu sendiri atau meneruskannya ke driver yang mendasar.
Fungsi yang dijalankan oleh pustaka kursor
Artikel-artikel ini menjelaskan ODBC mana yang memfungsikan pustaka kursor yang ditangani dan yang diteruskannya ke driver.
| Article | Description |
|---|---|
| Fungsi ODBC yang dijalankan oleh pustaka kursor | Mencantumkan fungsi yang diterapkan pustaka kursor itu sendiri untuk menyediakan fungsionalitas kursor yang dapat digulir. |
| Fungsi ODBC tidak dijalankan oleh pustaka kursor | Mencantumkan fungsi yang diteruskan pustaka kursor ke driver tanpa modifikasi. |
Pengikatan kolom dan parameter
Fungsi-fungsi ini menangani buffer aplikasi pengikatan ke kolom tataan hasil dan parameter pernyataan. Pustaka kursor memodifikasi perilakunya untuk mendukung pembaruan yang diposisikan dan memblokir kursor.
| Function | Description |
|---|---|
| SQLBindCol (Pustaka Kursor) | Mengikat buffer aplikasi ke kolom tataan hasil. Pustaka kursor melacak pengikatan untuk mendukung operasi pembaruan dan penghapusan yang diposisikan. |
| SQLBindParameter (Pustaka Kursor) | Mengikat buffer aplikasi ke penanda parameter. Pustaka kursor meneruskan panggilan ini ke driver. |
Operasi massal dan diposisikan
Fungsi-fungsi ini melakukan operasi massal pada set baris dan pembaruan yang diposisikan pada baris individual dalam kumpulan baris kursor saat ini.
| Function | Description |
|---|---|
| SQLBulkOperations (Pustaka Kursor) | Melakukan penyisipan massal, memperbarui, menghapus, atau mengambil menurut operasi marka buku. Pustaka kursor memetakan ini ketika SQLSetPos bekerja dengan driver ODBC 2.x. |
| SQLSetPos (Pustaka Kursor) | Memposisikan kursor dalam set baris dan memungkinkan aplikasi untuk menyegarkan, memperbarui, atau menghapus data dalam set baris. |
Manajemen dan transaksi kursor
Fungsi-fungsi ini mengelola masa pakai kursor dan batas transaksi.
| Function | Description |
|---|---|
| SQLCloseCursor (Pustaka Kursor) | Menutup kursor pada pernyataan dan membuang hasil yang tertunda. |
| SQLEndTran (Pustaka Kursor) | Menerapkan atau menggulung balik transaksi. Pustaka kursor mengelola status kursor di seluruh batas transaksi berdasarkan SQL_CURSOR_COMMIT_BEHAVIOR pengaturan dan SQL_CURSOR_ROLLBACK_BEHAVIOR . |
| SQLFreeStmt (Pustaka Kursor) | Menghentikan pemrosesan pernyataan, menutup kursor terkait, membuang hasil yang tertunda, dan secara opsional membebaskan semua sumber daya yang terkait dengan handel pernyataan. |
Pengambilan data
Fungsi-fungsi ini mengambil data dari kumpulan hasil. Pustaka kursor menyediakan fungsionalitas kursor yang dapat digulir untuk driver yang hanya mendukung kursor khusus ke depan.
| Function | Description |
|---|---|
| SQLFetch (Pustaka Kursor) | Mengambil kumpulan baris data berikutnya dari kumpulan hasil. Saat bekerja dengan driver ODBC 2.x, pustaka kursor memetakan ini ke SQLExtendedFetch. |
| SQLFetchScroll (Pustaka Kursor) | Mengambil kumpulan baris data yang ditentukan dari kumpulan hasil dan mengembalikan data untuk semua kolom terikat. Mendukung berbagai arah gulir termasuk pertama, terakhir, berikutnya, sebelumnya, absolut, dan posisi relatif. |
| SQLExtendedFetch (Pustaka Kursor) | Mengambil set baris yang ditentukan dari kumpulan hasil. Fungsi ini tidak digunakan lagi dalam ODBC 3.x; gunakan SQLFetchScroll sebagai gantinya. |
| SQLGetData (Pustaka Kursor) | Mengambil data untuk satu kolom dalam tataan hasil setelah SQLFetch atau SQLFetchScroll telah dipanggil. |
Operasi deskriptor
Fungsi-fungsi ini mendapatkan dan mengatur nilai bidang deskriptor. Deskriptor menentukan atribut parameter dan kolom tataan hasil.
| Function | Description |
|---|---|
| SQLGetDescField dan SQLGetDescRec (Pustaka Kursor) | Mengambil nilai bidang individual atau rekaman deskriptor lengkap. Pustaka kursor menangani ini untuk deskriptor internalnya. |
| SQLSetDescField dan SQLSetDescRec (Pustaka Kursor) | Atur nilai bidang individual atau rekaman deskriptor lengkap. Pustaka kursor melacak perubahan pada bidang deskriptor. |
Kueri kemampuan driver
Fungsi-fungsi ini mengembalikan informasi tentang kemampuan pustaka driver dan kursor.
| Function | Description |
|---|---|
| SQLGetFunctions (Pustaka Kursor) | Mengembalikan informasi tentang fungsi ODBC mana yang didukung driver. Pustaka kursor memodifikasi respons untuk menyertakan fungsi yang diterapkannya. |
| SQLGetInfo (Pustaka Kursor) | Mengembalikan informasi umum tentang driver dan sumber data. Pustaka kursor memodifikasi jenis informasi terkait kursor tertentu untuk mencerminkan kemampuannya. |
Atribut pernyataan dan koneksi
Fungsi-fungsi ini mendapatkan dan mengatur atribut pernyataan, koneksi, dan lingkungan yang memengaruhi perilaku kursor.
| Function | Description |
|---|---|
| SQLGetStmtAttr (Pustaka Kursor) | Mengembalikan nilai atribut pernyataan saat ini. Pustaka kursor menangani atribut yang terkait dengan perilaku kursor. |
| SQLGetStmtOption (Pustaka Kursor) | Mengembalikan nilai opsi pernyataan. Fungsi ini tidak digunakan lagi dalam ODBC 3.x; gunakan SQLGetStmtAttr sebagai gantinya. |
| SQLSetStmtAttr (Pustaka Kursor) | Mengatur atribut pernyataan. Pustaka kursor memproses atribut terkait kursor untuk menerapkan dukungan kursor yang dapat digulir. |
| SQLSetScrollOptions (Pustaka Kursor) | Mengatur opsi yang mengontrol perilaku kursor. Fungsi ini tidak digunakan lagi dalam ODBC 3.x; gunakan SQLSetStmtAttr dengan atribut terkait kursor sebagai gantinya. |
| SQLSetConnectAttr (Pustaka Kursor) | Mengatur atribut koneksi. Pustaka kursor memproses SQL_ATTR_ODBC_CURSORS atribut untuk mengaktifkan atau menonaktifkan penggunaan pustaka kursor. |
| SQLSetEnvAttr (Pustaka Kursor) | Mengatur atribut lingkungan. Pustaka kursor meneruskan panggilan ini ke Manajer Driver. |
Terjemahan SQL dan operasi baris
Fungsi-fungsi ini menangani terjemahan pernyataan SQL dan pengambilan jumlah baris.
| Function | Description |
|---|---|
| SQLNativeSql (Pustaka Kursor) | Mengembalikan string SQL seperti yang dimodifikasi oleh driver. Pustaka kursor meneruskan panggilan ini ke driver tanpa modifikasi. |
| SQLRowCount (Pustaka Kursor) | Mengembalikan jumlah baris yang dipengaruhi oleh pernyataan UPDATE, INSERT, atau DELETE. Pustaka kursor melacak jumlah baris untuk operasi pembaruan dan penghapusan yang diposisikan. |