sp_procoption (Transact-SQL)sp_procoption (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Définit ou désactive l'exécution automatique d'une procédure stockée.Sets or clears a stored procedure for automatic execution. Une procédure stockée qui est la valeur d’exécution automatique s’exécute chaque fois qu’une instance de SQL ServerSQL Server est démarré.A stored procedure that is set to automatic execution runs every time an instance of SQL ServerSQL Server is started.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


sp_procoption [ @ProcName = ] 'procedure'   
    , [ @OptionName = ] 'option'   
    , [ @OptionValue = ] 'value'   

ArgumentsArguments

[ @ProcName = ] 'procédure'[ @ProcName = ] 'procedure'
Est le nom de la procédure pour laquelle définir une option.Is the name of the procedure for which to set an option. procédure est nvarchar(776), sans valeur par défaut.procedure is nvarchar(776), with no default.

[ @OptionName = ] 'option'[ @OptionName = ] 'option'
Nom de l'option que vous voulez paramétrer.Is the name of the option to set. La seule valeur pour option est démarrage.The only value for option is startup.

[ @OptionValue = ] 'valeur'[ @OptionValue = ] 'value'
Indique si l’option sur (true ou sur) ou désactivé (false ou hors).Is whether to set the option on (true or on) or off (false or off). valeur est varchar(12), sans valeur par défaut.value is varchar(12), with no default.

Valeurs des codes de retourReturn Code Values

0 (succès) ou numéro d'erreur (échec)0 (success) or error number (failure)

NotesRemarks

Procédures de démarrage doivent se trouver dans le master de base de données et ne peut pas contenir de paramètres d’entrée ou de sortie.Startup procedures must be in the master database and cannot contain INPUT or OUTPUT parameters. 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.Execution of the stored procedures starts when all databases are recovered and the "Recovery is completed" message is logged at startup.

PermissionsPermissions

Nécessite l'appartenance au rôle serveur fixe sysadmin .Requires membership in the sysadmin fixed server role.

ExemplesExamples

L'exemple suivant définit une procédure en vue d'une exécution automatique.The following example sets a procedure for automatic execution.

EXEC sp_procoption @ProcName = '<procedure name>'   
    , @OptionName = ] 'startup'   
    , @OptionValue = 'on';   

L'exemple suivant empêche une procédure de s'exécuter automatiquement.The following example stops a procedure from executing automatically.

EXEC sp_procoption @ProcName = '<procedure name>'   
    , @OptionValue = 'off';   

Voir aussiSee Also

Exécuter une procédure stockéeExecute a Stored Procedure