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).

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)