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

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server нетБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Задает или отменяет хранимую процедуру для автоматического запуска.Sets or clears a stored procedure for automatic execution. Хранимая процедура настроена на выполнение при каждом запуске экземпляра SQL ServerSQL Server.A stored procedure that is set to automatic execution runs every time an instance of SQL ServerSQL Server is started.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

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

АргументыArguments

[ @ProcName = ] 'procedure' — Имя процедуры, для которого требуется задать параметр.[ @ProcName = ] 'procedure' Is the name of the procedure for which to set an option. процедураnvarchar(776) , не имеет значения по умолчанию.procedure is nvarchar(776), with no default.

[ @OptionName = ] 'option' Это имя можно задать значение.[ @OptionName = ] 'option' Is the name of the option to set. Единственное значение для параметрзапуска.The only value for option is startup.

[ @OptionValue = ] 'value' Указывает, следует ли данный аргумент (true или на) или выключается (false или off).[ @OptionValue = ] 'value' Is whether to set the option on (true or on) or off (false or off). значениеvarchar(12) , не имеет значения по умолчанию.value is varchar(12), with no default.

Значения кода возвратаReturn Code Values

0 (успешное завершение) или номер ошибки (неуспешное завершение)0 (success) or error number (failure)

ПримечанияRemarks

Процедуры автозапуска должны находиться в master базы данных и не может содержать параметры ввода или ВЫВОДА.Startup procedures must be in the master database and cannot contain INPUT or OUTPUT parameters. Выполнение хранимых процедур начинается после восстановления всех баз данных и регистрации сообщения «Восстановление завершено» во время начального запуска.Execution of the stored procedures starts when all databases are recovered and the "Recovery is completed" message is logged at startup.

РазрешенияPermissions

Необходимо членство в предопределенной роли сервера sysadmin .Requires membership in the sysadmin fixed server role.

ПримерыExamples

В следующем примере назначается процедура для автоматического выполнения.The following example sets a procedure for automatic execution.

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

В следующем примере останавливается автоматическое выполнение процедуры.The following example stops a procedure from executing automatically.

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

См. такжеSee Also

Выполнение хранимой процедурыExecute a Stored Procedure