sp_help_jobserver (Transact-SQL)
Devuelve información acerca del servidor para un trabajo dado.
.gif "Icono de vínculo a temas")
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.
Valores de código de retorno
0 (correcto) o 1 (error)
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 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 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.
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