sp_cursorexecute (T-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung)

Membuat dan mengisi kursor berdasarkan rencana eksekusi yang dibuat oleh sp_cursorprepare. Prosedur ini, ditambah dengan sp_cursorprepare, memiliki fungsi yang sama dengan sp_cursoropen, tetapi dibagi menjadi dua fase. sp_cursorexecute dipanggil dengan menentukan ID =4 dalam paket aliran data tabular (TDS).

tautan topikIkon Konvensi Sintaks Transact-SQL

Sintaks

  
sp_cursorexecute prepared_handle, cursor  
    [ , scrollopt[ OUTPUT ]  
    [ , ccopt[ OUTPUT ]  
    [ ,rowcount OUTPUT [ ,bound param][,...n]]]]]  

Argumen

prepared_handle
Apakah nilai handel pernyataan yang disiapkan dikembalikan oleh sp_cursorprepare. prepared_handle adalah parameter yang diperlukan yang memanggil nilai input int .

cursor
Adalah pengidentifikasi kursor yang dihasilkan SQL Server. kursor adalah parameter yang diperlukan yang harus disediakan pada semua prosedur berikutnya yang bertindak berdasarkan kursor, seperti sp_cursorfetch

scrollopt
Opsi gulir. scrollopt adalah parameter opsional yang memerlukan nilai input int . Parametersp_cursorexecute scrollopt memiliki opsi nilai yang sama dengan yang untuk sp_cursoropen.

Catatan

Nilai PARAMETERIZED_STMT tidak didukung.

Penting

Jika nilai scrollopt tidak ditentukan, nilai defaultnya adalah KEYSET terlepas dari nilai scrollopt yang ditentukan dalam sp_cursorprepare.

ccopt
Opsi kontrol mata uang. ccopt adalah parameter opsional yang memerlukan nilai input int . Parameterccopt sp_cursorexecute memiliki opsi nilai yang sama dengan yang untuk sp_cursoropen.

Penting

Jika nilai ccopt tidak ditentukan, nilai defaultnya adalah OPTIMIS terlepas dari nilai ccopt yang ditentukan dalam sp_cursorprepare.

rowcount
Adalah parameter opsional yang menandakan jumlah baris buffer pengambilan untuk digunakan dengan AUTO_FETCH. Defaultnya adalah 20 baris. rowcount bertingkah berbeda saat ditetapkan sebagai nilai input versus nilai yang dikembalikan.

Sebagai nilai input Sebagai nilai yang dikembalikan
Saat AUTO_FETCH ditentukan dengan FAST_FORWARD rowcount kursor mewakili jumlah baris yang akan ditempatkan ke dalam buffer pengambilan. Mewakili jumlah baris dalam tataan hasil. Saat nilai AUTO_FETCH scrollopt ditentukan, rowcount mengembalikan jumlah baris yang diambil ke dalam buffer pengambilan.

bound_param
Menandakan penggunaan opsional parameter tambahan.

Catatan

Parameter apa pun setelah yang kelima diteruskan ke rencana pernyataan sebagai parameter input.

Nilai Pengembalian Kode

rowcount dapat mengembalikan nilai berikut.

Nilai Deskripsi
-1 Jumlah baris yang tidak diketahui.
-n Populasi asinkron berlaku.

Keterangan

Parameter scrollopt dan ccopt

scrollopt dan ccopt berguna ketika rencana cache didahulukan untuk cache server, yang berarti bahwa handel yang disiapkan mengidentifikasi pernyataan harus dikompresi ulang. Nilai parameter scrollopt dan ccopt harus cocok dengan nilai yang dikirim dalam permintaan asli ke sp_cursorprepare.

Catatan

PARAMETERIZED_STMT tidak boleh ditetapkan ke scrollopt.

Kegagalan untuk memberikan nilai yang cocok akan mengakibatkan kompilasi ulang rencana, meniru operasi persiapan dan eksekusi.

Pertimbangan RPC dan TDS

Bendera input RETURN_METADATA RPC dapat diatur ke 1 untuk meminta agar kursor memilih metadata daftar dikembalikan di aliran TDS.

Lihat juga

sp_cursoropen (Transact-SQL)
sp_cursorfetch (T-SQL)
Prosedur Tersimpan Sistem (Transact-SQL)