sp_cursorprepare (Transact-SQL)

S’applique à : SQL Server

Compile l’instruction de curseur ou le lot dans un plan d’exécution, mais ne crée pas le curseur. L’instruction compilée peut être utilisée ultérieurement par sp_cursorexecute. Cette procédure, couplée avec sp_cursorexecute, a la même fonction que sp_cursoropen, mais est divisée en deux phases. sp_cursorprepare est appelé en spécifiant ID = 3 dans un paquet TDS (Tabular Data Stream).

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

prepared_handle

Identificateur préparé généré handle par SQL Server qui retourne une valeur int .

prepared_handle est ensuite fournie à une sp_cursorexecute procédure pour ouvrir un curseur. Une fois qu’un handle est créé, il existe jusqu’à ce que vous vous déconnectez, ou jusqu’à ce que vous le supprimiez explicitement par le biais d’une sp_cursorunprepare procédure.

params

Identifie des instructions paramétrables. La définition params des variables est remplacée par les marqueurs de paramètres dans l’instruction. params est un paramètre obligatoire qui appelle une valeur d’entrée ntext, nchar ou nvarchar . Entrez une NULL valeur si l’instruction n’est pas paramétrée.

Utilisez une chaîne ntext comme valeur d’entrée lorsque stmt est paramétré et que la valeur de défilement PARAMETERIZED_STMT est ON.

stmt

Définit le jeu de résultats de curseur. Le paramètre stmt est requis et appelle une valeur d’entrée ntext, **nchar ou nvarchar .

Les règles de spécification de la valeur stmt sont les mêmes que sp_cursoropen, à l’exception que le type de données de chaîne stmt doit être ntext.

options

Retourne une description des colonnes du jeu de résultats du curseur. Le paramètre d’options est int, avec la valeur par défaut NULL. Lorsqu’il est défini sur 0x0001, cela signifie RETURN_METADATA.

scrollopt

Option de défilement. Le paramètre scrollopt est un paramètre facultatif qui nécessite l’une des valeurs d’entrée int suivantes.

Étant donné que la valeur demandée peut ne pas convenir au curseur défini par stmt, ce paramètre sert d’entrée et de sortie. Dans de tels cas, SQL Server affecte une valeur appropriée.

ccopt

Option de contrôle en matière d'accès concurrentiel. ccopt est un paramètre facultatif qui nécessite l’une des valeurs d’entrée int suivantes.

Comme avec le défilement, SQL Server peut affecter une valeur différente de celle demandée.

Notes

Le paramètre d’état RPC est l’une des valeurs suivantes :

Exemples

Le code suivant est un exemple d’utilisation sp_cursorprepare et sp_cursorexecutede :

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;

Lorsque stmt est paramétré et que la valeur scrollopt PARAMETERIZED_STMT est ON, le format de la chaîne se présente sous la forme suivante :

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

Contenu connexe

• sp_cursorexecute (Transact-SQL)
• sp_cursoropen (Transact-SQL)
• sp_cursorunprepare (Transact-SQL)
• Procédures stockées système (Transact-SQL)