sp_procoption (Transact-SQL)

Aplica-se a: SQL Server

Define ou limpa um procedimento armazenado para execução automática. Um procedimento armazenado definido como execução automática é executado sempre que uma instância do SQL Server é iniciada.

Convenções de sintaxe de Transact-SQL

Sintaxe

sys.sp_procoption
    [ @ProcName = ] N'ProcName'
    , [ @OptionName = ] 'OptionName'
    , [ @OptionValue = ] 'OptionValue'
[ ; ]

Argumentos

@ProcName [ = ] N'ProcName'

O nome do procedimento para o qual definir uma opção. @ProcName é nvarchar(776), sem padrão.

@OptionName [ = ] 'Nome da opção'

O nome da opção a ser definida. @OptionName é varchar(35) e o único valor possível é startup.

@OptionValue [ = ] 'ValorDaOpção'

Se a opção deve ser ativada (true ou on) ou desativada (false ou off). @OptionValue é varchar(12), sem padrão.

Valores do código de retorno

0 (sucesso) ou número de erro (falha).

Comentários

Os procedimentos de inicialização devem estar no dbo esquema do banco de master dados e não podem conter INPUT parâmetros or 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 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 = N'<procedure name>',
    @OptionName = 'startup',
    @OptionValue = 'on';

O exemplo a seguir interrompe a execução automática de um procedimento.

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