sp_procoption (Transact-SQL)

Establece o borra la configuración de ejecución automática de un procedimiento almacenado. Un procedimiento almacenado establecido para ejecutarse automáticamente se ejecuta cada vez que se inicia una instancia de SQL Server.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @ProcName = ] 'procedure'
    Nombre del procedimiento para el cual se establece una opción. procedure es de tipo nvarchar(776) y no tiene ningún valor predeterminado.

  • [ @OptionName = ] 'option'
    Es el nombre de la opción que se va a establecer. El único valor para option es startup.

  • [ @OptionValue = ] 'value'
    Indica si se establece la opción como activada (true u on) o desactivada (false u off). value es de tipo varchar(12) y no tiene valor predeterminado.

Valores de código de retorno

0 (correcto) o número de error (error)

Comentarios

Los procedimientos de inicio deben estar en la base de datos master y no pueden contener parámetros de entrada (INPUT) ni salida (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

Debe pertenecer 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 = '<procedure name>' 
    , @OptionName = ] 'startup' 
    , @OptionValue = 'on'; 

En el ejemplo siguiente se detiene la ejecución automática de un procedimiento.

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

Vea también

Conceptos

Ejecutar un procedimiento almacenado