sp_start_job (Transact-SQL)
Indica al Agente SQL Server que ejecute un trabajo inmediatamente.
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
Identificado para fines informativos solamente. 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
Identificado para fines informativos solamente. No compatible. La compatibilidad con versiones posteriores no está garantizada.
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.
Valores de código de retorno
0 (correcto) o 1 (error)
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
Vea también
Referencia
sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)