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