sp_help_jobserver (Transact-SQL)
Devuelve información acerca del servidor para un trabajo dado.
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 de tipo uniqueidentifier y su valor predeterminado es NULL.
[ @job_name= ] 'job_name'
Nombre del trabajo cuya información se va a presentar. job_name es de tipo sysname y su valor predeterminado es NULL.[!NOTA] Se debe especificar job_id o job_name, pero no ambos.
- [ @show_last_run_details= ] show_last_run_details
Indica si la información acerca de la última ejecución forma parte del conjunto de resultados. show_last_run_details es de tipo tinyint y su valor predeterminado es 0. 0 no incluye información acerca de la última ejecución y 1 lo hace.
Conjuntos de resultados
| Nombre de 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 principal. |
last_poll_date |
datetime |
Fecha en que el servidor de destino sondeó por última vez el servidor principal. |
Si sp_help_jobserver se ejecuta con show_last_run_details establecido en 1, el conjunto de resultados tiene estas columnas adicionales.
| Nombre de 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 = No realizado 1 = Realizado 3 = Cancelado 5 = Desconocido |
Permisos
De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros de la función fija de servidor sysadmin. Al resto de usuarios se les debe conceder 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 detalles sobre los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole sólo pueden ver la información de los trabajos que les pertenecen.
Valores de código de retorno
0 (correcto) o 1 (error)
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
Vea también
Referencia
sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)