sp_procoption (Transact-SQL)
S’applique à : SQL Server
Définit ou désactive l'exécution automatique d'une procédure stockée. Procédure stockée définie sur l’exécution automatique à chaque démarrage d’une instance de SQL Server.
Conventions de la syntaxe Transact-SQL
Syntaxe
sys.sp_procoption
[ @ProcName = ] N'ProcName'
, [ @OptionName = ] 'OptionName'
, [ @OptionValue = ] 'OptionValue'
[ ; ]
Arguments
[ @ProcName = ] N'ProcName'
Nom de la procédure pour laquelle définir une option. @ProcName est nvarchar(776), sans valeur par défaut.
[ @OptionName = ] 'OptionName'
Nom de l'option à définir. @OptionName est varchar(35), et la seule valeur possible est startup
.
[ @OptionValue = ] 'OptionValue'
Indique si l’option est activée (true
ou on
) ou désactivée (false
ou off
). @OptionValue est varchar(12), sans valeur par défaut.
Valeurs des codes de retour
0
(réussite) ou numéro d’erreur (échec).
Notes
Les procédures de démarrage doivent se trouver dans le dbo
schéma de la master
base de données et ne peuvent pas contenir ou OUTPUT
paramètresINPUT
. L'exécution des procédures stockées démarre lorsque toutes les bases de données sont récupérées et le message « Récupération terminée » est enregistré au démarrage.
autorisations
Nécessite l'appartenance au rôle serveur fixe sysadmin .
Exemples
L'exemple suivant définit une procédure en vue d'une exécution automatique.
EXEC sp_procoption @ProcName = N'<procedure name>',
@OptionName = 'startup',
@OptionValue = 'on';
L'exemple suivant empêche une procédure de s'exécuter automatiquement.
EXEC sp_procoption @ProcName = N'<procedure name>',
@OptionName = 'startup',
@OptionValue = 'off';