sp_help_jobserver (Transact-SQL)
Devuelve información acerca del servidor para un trabajo dado.
.gif "Icono de vínculo a temas")
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 de tipo uniqueidentifier y su valor predeterminado es NULL.[ @job_name= ] 'job_name'
Nombre del trabajo para el que se devuelve información. 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 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 detalles sobre los permisos de estos roles, vea Roles fijos de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole solo 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
Vea también
Referencia
sp_add_jobserver (Transact-SQL)