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';