sp_cursorprepare (Transact-SQL)

Si applica a: SQL Server

Compila l'istruzione cursore o il batch in un piano di esecuzione, ma non crea il cursore. L'istruzione compilata può essere usata in un secondo momento da sp_cursorexecute. Questa procedura, associata a sp_cursorexecute, ha la stessa funzione di sp_cursoropen, ma è suddivisa in due fasi. sp_cursorprepare viene richiamato specificando ID = 3 in un pacchetto TDS (Tabular Data Stream).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_cursorprepare prepared_handle OUTPUT , params , stmt , options
    [ , scrollopt [ , ccopt ] ]
[ ; ]

Argomenti

prepared_handle

Identificatore preparato handle generato da SQL Server che restituisce un valore int .

prepared_handle viene quindi fornito a una sp_cursorexecute routine per aprire un cursore. Dopo aver creato un handle, esiste fino a quando non si disconnette o fino a quando non viene rimosso in modo esplicito tramite una sp_cursorunprepare procedura.

params

Identifica le istruzioni con parametri. La definizione di parametri delle variabili viene sostituita dai marcatori di parametro nell'istruzione . params è un parametro obbligatorio che chiama per un valore di input ntext, nchar o nvarchar . Immettere un NULL valore se l'istruzione non è parametrizzata.

Usare una stringa ntext come valore di input quando stmt viene parametrizzato e il valore di scrollopt PARAMETERIZED_STMT è ON.

stmt

Definisce il set di risultati del cursore. Il parametro stmt è obbligatorio e chiama un valore di input ntext, **nchar o nvarchar .

Le regole per specificare il valore stmt sono uguali sp_cursoropena , con l'eccezione che il tipo di dati stringa stmt deve essere ntext.

options

Restituisce una descrizione delle colonne del set di risultati del cursore. Il parametro options è int, con un valore predefinito .NULL Se impostato su 0x0001, significa RETURN_METADATA.

scrollopt

Opzione di scorrimento. Il parametro scrollopt è un parametro facoltativo che richiede uno dei valori di input int seguenti.

Poiché il valore richiesto potrebbe non essere appropriato per il cursore definito da stmt, questo parametro funge sia da input che da output. In questi casi, SQL Server assegna un valore appropriato.

ccopt

Opzioni del controllo della concorrenza. ccopt è un parametro facoltativo che richiede uno dei valori di input int seguenti.

Come per scrollpt, SQL Server può assegnare un valore diverso da quello richiesto.

Osservazioni:

Il parametro di stato RPC è uno dei valori seguenti:

Esempi

Il codice seguente è un esempio di utilizzo sp_cursorprepare di e sp_cursorexecute:

DECLARE @handle INT, @p5 INT, @p6 INT;

EXEC sp_cursorprepare @handle OUTPUT,
    N'@dbid int',
    N'select * from sys.databases where database_id < @dbid',
    1,
    @p5 OUTPUT,
    @p6 OUTPUT;

DECLARE @p1 INT
SET @P1 = @handle;

DECLARE @p2 INT;
DECLARE @p3 INT;
DECLARE @p4 INT;

SET @P6 = 4;

EXEC sp_cursorexecute @p1,
    @p2 OUTPUT,
    @p3 OUTPUT,
    @p4 OUTPUT,
    @p5 OUTPUT,
    @p6;

EXEC sp_cursorfetch @P2;
EXEC sp_cursorunprepare @handle;
EXEC sp_cursorclose @p2;

Quando stmt viene parametrizzato e il valore scrollopt PARAMETERIZED_STMT è ON, il formato della stringa è nel formato seguente:

<parameter_name> <data_type> [ ,... n ]

Contenuto correlato

• sp_cursorexecute (Transact-SQL)
• sp_cursoropen (Transact-SQL)
• sp_cursorunprepare (Transact-SQL)
• Stored procedure di sistema (Transact-SQL)