Compartir a través de

sp_help_jobserver (Transact-SQL)

  • Artículo

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 = ] N'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.

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

[ @job_name = ] N'job_name'

Nombre del trabajo para el que se devuelve información. @job_name es sysname, con un valor predeterminado de NULL.

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

[ @show_last_run_details = ] show_last_run_details

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.
  • 1 incluye información de última ejecución.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto 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 1en , 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

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • 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

Contenido relacionado