sys.sp_procoption (Transact-SQL)

Aplica-se a: SQL Server

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

Transact-SQL convenções de sintaxe

Syntax

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

Arguments

[ @ProcName = ] N'ProcName'

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

[ @OptionName = ] 'NomeDeopção'

O nome da opção para definir. @OptionName é varchar(35), e o único valor possível é startup.

[ @OptionValue = ] 'ValorOption'

Especifica se deve ativar ou desativar a opção. @OptionValue é varchar(12), sem padrão, e pode ser um dos seguintes valores:

Enabled Disabled
true false
on off
yes no
1 0

Valores de código de retorno

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

Remarks

Os procedimentos de arranque devem estar no dbo esquema da master base de dados e não podem conter INPUT parâmetros OUTPUT . A execução dos procedimentos armazenados começa quando todas as bases de dados são recuperadas e a mensagem "Recuperação concluída" é registada no arranque.

Permissions

Requer associação na função fixa de servidor sysadmin.

Examples

O exemplo seguinte estabelece um procedimento para execução automática.

EXECUTE sp_procoption
    @ProcName = N'<procedure name>',
    @OptionName = 'startup',
    @OptionValue = 'on';

O exemplo seguinte impede que um procedimento seja executado automaticamente.

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