sp_help_jobserver (Transact-SQL)

Se aplica a:SQL Server

Devuelve información acerca del servidor para un trabajo dado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
sp_help_jobserver  
     { [ @job_id = ] job_id   
     | [ @job_name = ] 'job_name' }  
     [ , [ @show_last_run_details = ] show_last_run_details ]  

Argumentos

[ @job_id = ] job_id Número de identificación del trabajo para el que se va a devolver información. job_id es uniqueidentifier, con un valor predeterminado de NULL.

[ @job_name = ] 'job_name' Nombre del trabajo para el que se va a devolver información. job_name es sysname, con un valor predeterminado de NULL.

Nota

Se deben especificar job_id o job_name , pero no se pueden especificar ambos.

[ @show_last_run_details = ] show_last_run_details Es si la información de ejecución de la última ejecución forma parte del conjunto de resultados. show_last_run_details es tinyint, con un valor predeterminado de 0. 0 no incluye información de última ejecución y 1 sí.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de la columna Tipo de datos Descripción
server_id int Número de identificación del servidor de destino.
server_name nvarchar(30) Nombre de equipo del servidor de destino.
enlist_date datetime Fecha de alta del servidor de destino en el servidor maestro.
last_poll_date datetime Fecha en que el servidor de destino sondeó por última vez el servidor maestro.

Si sp_help_jobserver se ejecuta con show_last_run_details establecido en1, el conjunto de resultados tiene estas columnas adicionales.

Nombre de la columna Tipo de datos Descripción
last_run_date int Fecha del inicio de la última ejecución del trabajo en este servidor de destino.
last_run_time int Hora del inicio de la última ejecución del trabajo en este servidor de destino
last_run_duration int Duración del trabajo en su última ejecución en este servidor de destino (en segundos)
last_outcome_message nvarchar(1024) Describe el último resultado del trabajo.
last_run_outcome int Resultado del trabajo la última vez que se ejecutó en este servidor:

0 = Error

1 = Correcto

3 = Cancelado

5 = Desconocido

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 detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole solo pueden ver información de los trabajos que poseen.

Ejemplos

En el ejemplo siguiente se devuelve información acerca del trabajo NightlyBackups, incluida la información sobre la última ejecución.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobserver  
    @job_name = N'NightlyBackups',  
    @show_last_run_details = 1 ;  
GO  

Consulte también

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)