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

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Define ou limpa um procedimento armazenado para execução automática.Sets or clears a stored procedure for automatic execution. Um procedimento armazenado que é definido como execuções de execução automática sempre que uma instância de SQL ServerSQL Server é iniciado.A stored procedure that is set to automatic execution runs every time an instance of SQL ServerSQL Server is started.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

[ @ProcName = ] 'procedure' É o nome do procedimento para o qual definir uma opção.[ @ProcName = ] 'procedure' Is the name of the procedure for which to set an option. procedimento está nvarchar(776) , sem padrão.procedure is nvarchar(776), with no default.

[ @OptionName = ] 'option' É o nome da opção a ser definido.[ @OptionName = ] 'option' Is the name of the option to set. O único valor para opção é inicialização.The only value for option is startup.

[ @OptionValue = ] 'value' Se deseja definir a opção on (true ou na) ou desativado (false ou off).[ @OptionValue = ] 'value' Is whether to set the option on (true or on) or off (false or off). valor está varchar(12) , sem padrão.value is varchar(12), with no default.

Valores do código de retornoReturn Code Values

0 (êxito) ou um número de erro (falha)0 (success) or error number (failure)

ComentáriosRemarks

Procedimentos de inicialização devem estar na mestre de banco de dados e não pode conter parâmetros de entrada ou saída.Startup procedures must be in the master database and cannot contain INPUT or OUTPUT parameters. 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.Execution of the stored procedures starts when all databases are recovered and the "Recovery is completed" message is logged at startup.

PermissõesPermissions

Exige associação à função de servidor fixa sysadmin .Requires membership in the sysadmin fixed server role.

ExemplosExamples

O exemplo a seguir define um procedimento para execução automática.The following example sets a procedure for automatic execution.

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

O exemplo a seguir interrompe a execução automática de um procedimento.The following example stops a procedure from executing automatically.

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

Consulte tambémSee Also

Executar um procedimento armazenadoExecute a Stored Procedure