sp_procoption (Transact-SQL)
Se aplica a: SQL Server
Establece o borra la configuración de ejecución automática de un procedimiento almacenado. Un procedimiento almacenado que se establece en ejecución automática se ejecuta cada vez que se inicia una instancia de SQL Server.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sys.sp_procoption
[ @ProcName = ] N'ProcName'
, [ @OptionName = ] 'OptionName'
, [ @OptionValue = ] 'OptionValue'
[ ; ]
Argumentos
[ @ProcName = ] N'ProcName'
Nombre del procedimiento para el que se va a establecer una opción. @ProcName es nvarchar(776), sin ningún valor predeterminado.
[ @OptionName = ] 'OptionName'
Nombre de la opción que se va a establecer. @OptionName es varchar(35) y el único valor posible es startup
.
[ @OptionValue = ] 'OptionValue'
Indica si se va a establecer la opción en (true
o on
) o desactivada (false
o off
). @OptionValue es varchar(12), sin ningún valor predeterminado.
Valores de código de retorno
0
(correcto) o número de error (error).
Comentarios
Los procedimientos de inicio deben estar en el dbo
esquema de la master
base de datos y no pueden contener INPUT
parámetros o OUTPUT
. La ejecución de los procedimientos almacenados comienza cuando se recuperan todas las bases de datos y se registra el mensaje "Se completó la recuperación" en el inicio.
Permisos
Requiere la pertenencia al rol fijo de servidor sysadmin .
Ejemplos
En el ejemplo siguiente se establece un procedimiento para la ejecución automática.
EXEC sp_procoption @ProcName = N'<procedure name>',
@OptionName = 'startup',
@OptionValue = 'on';
En el ejemplo siguiente se detiene la ejecución automática de un procedimiento.
EXEC sp_procoption @ProcName = N'<procedure name>',
@OptionName = 'startup',
@OptionValue = 'off';