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.

Ícone de vínculo de tópico 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'; 

Consulte também

Conceitos

Executar um procedimento armazenado