sp_procoption (Transact-SQL)
Define ou limpa um procedimento armazenado para execução automática. Um procedimento armazenado que está definido para execução automática será executado toda vez que uma instância do SQL Server for iniciada.
Convenções da sintaxe Transact-SQL
Sintaxe
sp_procoption [ @ProcName = ] 'procedure'
, [ @OptionName = ] 'option'
, [ @OptionValue = ] 'value'
Argumentos
[ @ProcName = ] 'procedure'
É o nome do procedimento para o qual uma opção será definida. procedure é nvarchar(776), sem padrão.[ @OptionName = ] 'option'
É o nome da opção a ser definida. O único valor para option é startup.[ @OptionValue = ] 'value'
É o fato de a opção ser definida como ativada (true ou on) ou desativada (false ou off). value é varchar(12), sem padrão.
Valores de código de retorno
0 (êxito) ou um número de erro (falha)
Comentários
Os procedimentos de inicialização devem estar no banco de dados mestre e não podem conter parâmetros INPUT ou OUTPUT. A execução dos procedimentos armazenados inicia quando todos os bancos de dados são recuperados e a mensagem "A recuperação foi concluída" é registrada na inicialização.
Permissões
Exige a associação à função de servidor fixa sysadmin.
Exemplos
O exemplo a seguir define um procedimento para execução automática.
EXEC sp_procoption @ProcName = '<procedure name>'
, @OptionName = ] 'startup'
, @OptionValue = 'on';
O exemplo a seguir interrompe a execução automática de um procedimento.
EXEC sp_procoption @ProcName = '<procedure name>'
, @OptionValue = 'off';