sp_procoption (Transact-SQL)

  • Artículo

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';

Contenido relacionado