sp_start_job (Transact-SQL)
Indica al Agente SQL Server que ejecute un trabajo inmediatamente.
.gif "Icono de vínculo a temas")
Convenciones 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 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 ambos. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.[ @error_flag= ] error_flag
Solamente 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 a los que el trabajo se dirige actualmente.[ @step_name= ] 'step_name'
Nombre del paso en el que se iniciará la ejecución del trabajo. Solo se aplica a trabajos locales. step_name es de tipo sysname y su valor predeterminado es NULL.[ @output_flag= ] output_flag
Solamente 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
Comentarios
Este procedimiento almacenado se encuentra en la base de datos msdb.
Permisos
De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos 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 estos roles, vea Roles fijos de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole y SQLAgentReaderRole solo 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