Megosztás a következőn keresztül:


sp_cursorexecute (Transact-SQL)

A következőkre vonatkozik:SQL Server

Létrehoz és feltölt egy kurzort a sp_cursorprepareáltal létrehozott végrehajtási terv alapján. Ez az eljárás sp_cursorprepareegyütt ugyanazzal a funkcióval rendelkezik, mint sp_cursoropen, de két fázisra van osztva. sp_cursorexecute meghívása ID = 4 megadásával történik egy táblázatos adatfolyam-(TDS-) csomagban.

Transact-SQL szintaxis konvenciói

Szintaxis

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

Érvek

Fontos

A kiterjesztett tárolt eljárások argumentumait a Szintaxis szakaszban leírt sorrendben kell megadni. Ha a paraméterek sorrenden kívül vannak beírva, hibaüzenet jelenik meg.

prepared_handle

Az előkészített utasítás kezelisp_cursorprepareáltal visszaadott értéket. A prepared_handle paraméter int, és nem lehet NULL.

kurzor

Az adatbázismotor által létrehozott kurzorazonosító. kurzor egy kötelező paraméter, amelyet a kurzort követő összes további eljáráshoz meg kell adni, például sp_cursorfetch.

scrollopt

Görgetési lehetőség. A scrollopt paraméter int, alapértelmezett értéke NULL. A sp_cursorexecutescrollopt paraméter ugyanazokat az értékbeállításokat használja, mint sp_cursoropen.

A PARAMETERIZED_STMT érték nem támogatott.

Ha nincs megadva görgetőgomb érték, az alapértelmezett érték KEYSET, függetlenül attól, hogy görgetőgombsp_cursorpreparemegadott értéket.

ccopt

Pénznem-vezérlési lehetőség. ccopt egy választható paraméter, amely int bemeneti értéket igényel. A sp_cursorexecuteccopt paraméternek ugyanazok az értékbeállításai vannak, mint sp_cursoropen.

Ha nincs megadva ccopt érték, az alapértelmezett érték OPTIMISTIC, függetlenül attól, hogy ccoptsp_cursorprepare.

sorszám

Választható paraméter, amely a AUTO_FETCHhasználandó lekérési puffersorok számát jelzi. Az alapértelmezett érték 20 sor. sorszám eltérően viselkedik, ha bemeneti értékként van hozzárendelve a visszatérési értékhez képest.

Bemeneti értékként Visszatérési értékként
Ha AUTO_FETCHFAST_FORWARD kurzorokkal van megadva, sorszám a beolvasási pufferbe helyezendő sorok számát jelöli. Az eredményhalmaz sorainak számát jelöli. A scrolloptAUTO_FETCH érték megadásakor sorszám a beolvasási pufferbe beolvasott sorok számát adja vissza.

bound_param

A további paraméterek opcionális használatát jelzi.

Az ötödik utáni paramétereket a rendszer bemeneti paraméterekként továbbítja az utasítástervnek.

Kódértékek visszaadása

sorszám a következő értékeket adja vissza.

Érték Leírás
-1 Ismeretlen sorok száma.
-n Az aszinkron populáció érvényben van.

Megjegyzések

scrollopt és ccopt paraméterek

scrollopt és ccopt akkor lehet hasznos, ha a gyorsítótárazott tervek előre vannak telepítve a kiszolgáló gyorsítótárához, ami azt jelenti, hogy az utasítást azonosító előkészített leírót újra kell összeállítani. A scrollopt és ccopt paraméterértékének meg kell egyeznie az eredeti kérésben sp_cursorprepareküldött értékekkel.

PARAMETERIZED_STMT nem szabad hozzárendelni görgetőgombhoz.

Az egyező értékek meg nem adása a tervek újrafordítását eredményezi, ami a előkészítési és végrehajtási műveletek negativálását eredményezi.

RPC- és TDS-szempontok

Az RPC RETURN_METADATA beviteli jelölő 1 állítható be, hogy a kurzorválasztó lista metaadatainak visszaadása a TDS-adatfolyamban legyen.