sp_cursorexecute (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Erstellt und füllt einen Cursor basierend auf dem von sp_cursorprepare. Dieses Verfahren, gekoppelt mit sp_cursorprepare, hat die gleiche Funktion wie sp_cursoropen, aber wird in zwei Phasen aufgeteilt. sp_cursorexecute wird aufgerufen, indem in einem TDS-Paket (Tabular Data Stream) angegeben ID = 4 wird.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

prepared_handle

Der vorbereitete Anweisungshandle-Wert, der von sp_cursorprepare. Der parameter prepared_handle ist int und kann nicht sein NULL.

Cursor

Der Datenbank-Engine generierte Cursorbezeichner. Cursor ist ein erforderlicher Parameter, der für alle nachfolgenden Prozeduren angegeben werden muss, die auf den Cursor reagieren, z sp_cursorfetch. B. .

scrollopt

Option für den Bildlauf. Der Scrollopt-Parameter ist int mit einem Standardwert von NULL. Der sp_cursorexecute Scrollopt-Parameter weist die gleichen Wertoptionen auf wie sp_cursoropen.

Der PARAMETERIZED_STMT Wert wird nicht unterstützt.

Wenn kein Bildlaufoptwert angegeben ist, ist KEYSET der Standardwert unabhängig vom in der Datei angegebenen sp_cursorprepareScrollopt-Wert.

Kcopt

Option für die Währungssteuerung. ccopt ist ein optionaler Parameter, der einen Int-Eingabewert erfordert. Der sp_cursorexecuteCcopt-Parameter hat die gleichen Wertoptionen wie sp_cursoropen.

Wenn kein Ccopt-Wert angegeben ist, ist OPTIMISTIC der Standardwert unabhängig vom in sp_cursorprepare.

Rowcount

Ein optionaler Parameter, der die Anzahl der Abrufpufferzeilen angibt, die für die Verwendung verwendet AUTO_FETCHwerden sollen. Der Standardwert ist 20 Zeilen. Rowcount verhält sich anders, wenn ein Eingabewert als Eingabewert oder ein Rückgabewert zugewiesen wird.

Als Eingabewert Als Rückgabewert
Wenn AUTO_FETCH mit FAST_FORWARD Cursorn angegeben wird, stellt "rowcount" die Anzahl der Zeilen dar, die in den Abrufpuffer eingefügt werden sollen. Stellt die Anzahl der Zeilen im Resultset dar. Wenn der Scrollopt-Wert AUTO_FETCH angegeben wird, gibt rowcount die Anzahl der Zeilen zurück, die in den Abrufpuffer abgerufen wurden.

bound_param

Kennzeichnet die optionale Verwendung zusätzlicher Parameter.

Alle nach dem fünften Parameter übergebenen Parameter werden als Eingabeparameter an den Anweisungsplan übergeben.

Rückgabecodewerte

rowcount gibt die folgenden Werte zurück.

Wert Beschreibung
-1 Die Anzahl der unbekannten Zeilen.
-n Eine asynchrone Auffüllung ist wirksam.

Hinweise

scrollopt-Parameter und ccopt-Parameter

Scrollopt und Ccopt sind nützlich, wenn die zwischengespeicherten Pläne für den Servercache vorab eingestellt werden, was bedeutet, dass der vorbereitete Handle, der die Anweisung identifiziert, neu kompiliert werden muss. Die Werte für scrollopt- und ccopt-Parameter müssen mit den Werten übereinstimmen, die in der ursprünglichen Anforderung gesendet werden.sp_cursorprepare

PARAMETERIZED_STMT sollte nicht dem Scrollopt zugewiesen werden.

Fehler beim Bereitstellen übereinstimmender Werte bei der Neukompilierung der Pläne, wobei die Vorbereitungs- und Ausführungsvorgänge negiert werden.

Überlegungen zu RPC und TDS

Das RPC-Eingabeflagge RETURN_METADATA kann so festgelegt 1 werden, dass die Cursorauswahllistenmetadaten im TDS-Datenstrom zurückgegeben werden.

Zugehöriger Inhalt