Compartir a través de

  • Artículo

sp_start_job (Transact-SQL)

Indica al Agente SQL Server que ejecute un trabajo inmediatamente.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_start_job 
     {   [@job_name =] 'job_name'
       | [@job_id =] job_id }
     [ , [@error_flag =] error_flag]
     [ , [@server_name =] 'server_name']
     [ , [@step_name =] 'step_name']
     [ , [@output_flag =] output_flag]

Argumentos

  • [ @job_name= ] 'job_name'
    Nombre del trabajo que se va a iniciar. Se debe especificar job_id o job_name, pero no se pueden especificar ambos. job_name es de tipo sysname y su valor predeterminado es NULL.

  • [ @job_id= ] job_id
    Número de identificación del trabajo que se va a iniciar. Se debe especificar job_id o job_name, pero no se pueden especificar ambos. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.

  • [ @error_flag= ] error_flag
    Solo se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.

  • [ @server_name= ] 'server_name'
    Servidor de destino en el que se va a iniciar el trabajo. server_name es de tipo nvarchar(128) y su valor predeterminado es NULL. server_name debe ser uno de los servidores de destino en los que el trabajo está destinado actualmente.

  • [ @step_name= ] 'step_name'
    Nombre del paso en el que se iniciará la ejecución del trabajo. Sólo se aplica a trabajos locales. step_name es de tipo sysname y su valor predeterminado es NULL.

  • [ @output_flag= ] output_flag
    Solo se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Notas

Este procedimiento almacenado se encuentra en la base de datos msdb.

Permisos

De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Para obtener más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole y SQLAgentReaderRole sólo pueden ver trabajos de los que sean propietarios. Los miembros de SQLAgentOperatorRole pueden iniciar todos los trabajos locales, incluidos los que sean propiedad de otros usuarios. Los miembros de sysadmin pueden iniciar todos los trabajos locales y multiservidor.

Ejemplos

En el siguiente ejemplo se inicia un trabajo llamado Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO