sp_cursorprepexec (Transact-SQL)

Gilt für:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Datenbank in Microsoft Fabric

Kompiliert einen Plan für die gesendete Cursoranweisung oder den gesendeten Batch, erstellt dann den Cursor und füllt ihn auf. sp_cursorprepexec kombiniert die Funktionen von sp_cursorprepare und sp_cursorexecute. Diese Prozedur wird aufgerufen, indem in einem TDS-Paket (Tabular Data Stream) angegeben ID = 5 wird.

Transact-SQL-Syntaxkonventionen

Syntax

sp_cursorprepexec prepared handle OUTPUT , cursor OUTPUT , params , statement , options
    [ , scrollopt [ , ccopt [ , rowcount ] ] ]
    [ , '@parameter_name [ , ...n ]' ]

Argumente

vorbereiteter Handle

Ein VON SQL Server generierter Handlebezeichner . Der vorbereitete Handle-Parameter ist erforderlich und gibt int zurück.

Cursor

Der sql Server generierte Cursorbezeichner . Der Cursorparameter ist ein erforderlicher Parameter, der für alle nachfolgenden Prozeduren angegeben werden muss, die auf diesen Cursor reagieren, z sp_cursorfetch. B. .

params

Identifiziert parametrisierte Anweisungen. Die params -Definition der Variablen wird in der Anweisung an die Stelle der Parametermarkierungen gesetzt. Der Parameter "params" ist erforderlich. Wenn angegeben, ruft Params einen ntext-, nchar- oder nvarchar-Eingabewert auf.

Anweisung

Definiert das Resultset des Cursors. Der Anweisungsparameter ist erforderlich und ruft einen ntext-, nchar- oder nvarchar-Eingabewert auf.

Optionen

Ein optionaler Parameter, der eine Beschreibung der Spalten im Cursorresultset zurückgibt. Der Optionsparameter erfordert den folgenden Int-Eingabewert .

scrollopt

Option für den Bildlauf. Der Scrollopt-Parameter ist optional. Wenn angegeben, erfordert Scrollopt einen der folgenden Int-Eingabewerte .

Aufgrund der Möglichkeit, dass die angeforderte Option für den durch Anweisung definierten Cursor nicht geeignet ist, dient dieser Parameter sowohl als Eingabe als auch als Ausgabe. In solchen Fällen weist SQL Server einen geeigneten Typ zu und ändert diesen Wert.

Kcopt

Option für die Parallelitätssteuerung. Der Ccopt-Parameter ist optional. Wenn angegeben, erfordert der Ccopt-Parameter einen der folgenden Int-Eingabewerte .

Wie bei scrollopt kann SQL Server einen anderen Wert als die angeforderte zuweisen.

Rowcount

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

parameter_name

Legt einen oder mehrere Parameternamen fest, wie im Parameter "params " definiert. Für jeden Parameter, der in Params enthalten ist, muss ein Parameter angegeben werden. Dieser Parameter ist nicht erforderlich, wenn die Transact-SQL-Anweisung oder der Batch in Params keine Parameter definiert hat.

Rückgabecodewerte

Wenn der Paramswert zurückgegeben wird NULL, wird die Anweisung nicht parametrisiert.

Beispiele

In diesem Beispiel wird die Verwendung von sp_cursorprepexec. Es wird eine Abfrage für die Tabelle in der Person Datenbank ausgeführt, die AdventureWorks2025 alle Datensätze zurückgibt, bei denen der Vorname "Kirby" lautet.

USE AdventureWorks2022;
GO

DECLARE @prep_handle INT,
    @cursor INT,
    @scrollopt INT = 4104,
    @ccopt INT = 8193,
    @rowcnt INT;

EXECUTE sp_cursorprepexec
    @prep_handle OUTPUT,
    @cursor OUTPUT,
    N'@fName nvarchar(100)',
    N'SELECT FirstName, LastName FROM Person.Person WHERE FirstName = @fName',
    @scrollopt,
    @ccopt,
    @rowcnt OUTPUT,
    'Kirby';

EXECUTE sp_cursorfetch @cursor;

Zugehöriger Inhalt

• sp_cursoropen (Transact-SQL)
• sp_cursorexecute (Transact-SQL)
• sp_cursorprepare (Transact-SQL)
• sp_cursorfetch (Transact-SQL)
• Gespeicherte Systemprozeduren (Transact-SQL)