Partager via


sp_prepexec (Transact-SQL)

Prépare et exécute une instruction Transact-SQL paramétrable. sp_prepexec combine les fonctions de sp_prepare et de sp_execute. L'appel est effectué en spécifiant ID = 13 dans un paquet TDS (Tabular Data Stream).

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

Syntaxe

sp_prepexec handle OUTPUT, params , stmt
    [ , bound param ] [ ,...n ] ]

Arguments

  • handle
    Identificateur de handle 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.

  • bound_param
    Indique l'utilisation facultative de paramètres supplémentaires. bound_param demande une valeur d'entrée de tout type de données pour désigner les paramètres supplémentaires en cours d'utilisation.

Exemple

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

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

Voir aussi

Référence

sp_prepare (Transact SQL)

sp_execute (Transact-SQL)

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