Partager via


sp_prepare (Transact SQL)

Prépare une instruction Transact-SQL paramétrable et retourne un handle d'instruction pour l'exécution. sp_prepare est appelé en spécifiant ID = 11 dans un paquet TDS (Tabular Data Stream).

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sp_prepare handle OUTPUT, params, stmt, options

Arguments

  • handle
    Identificateur de handle préparé généré par SQL Server. handle est un paramètre obligatoire avec une valeur de retour int.

  • params
    Identifie des instructions paramétrables. La définition params de variables est substituée aux marqueurs de paramètre dans l'instruction. params est un paramètre obligatoire qui demande une valeur d'entrée ntext, nchar ou nvarchar . Entrez une valeur NULL si l'instruction n'est pas paramétrable.

  • stmt
    Définit le jeu de résultats de curseur. Le paramètre stmt est obligatoire et demande une valeur d'entrée ntext, nchar ou nvarchar.

  • options
    Paramètre optionnel qui retourne une description des colonnes du jeu de résultats du curseur. options requiert la valeur d'entrée int suivante.

    Valeur

    Description

    0x0001

    RETURN_METADATA

Exemples

L'exemple suivant prépare et exécute une instruction simple.

Declare @P1 int;
Exec sp_prepare @P1 output, 
    N'@P1 nvarchar(128), @P2 nvarchar(100)',
    N'SELECT database_id, name FROM sys.databases WHERE name=@P1 AND state_desc = @P2';
Exec sp_execute @P1, N'tempdb', N'ONLINE';
EXEC sp_unprepare @P1;

Voir aussi

Référence

Procédures stockées système (Transact-SQL)