sp_help_job (Transact-SQL)

Devuelve información acerca de los trabajos que el Agente SQL Server utiliza para realizar actividades automatizadas en SQL Server.

Sintaxis

sp_help_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } 
     [ , [ @job_aspect = ] 'job_aspect' ] 
     [ , [ @job_type = ] 'job_type' ] 
     [ , [ @owner_login_name = ] 'login_name' ] 
     [ , [ @subsystem = ] 'subsystem' ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @enabled = ] enabled ] 
     [ , [ @execution_status = ] status ] 
     [ , [ @date_comparator = ] 'date_comparison' ] 
     [ , [ @date_created = ] date_created ] 
     [ , [ @date_last_modified = ] date_modified ] 
     [ , [ @description = ] 'description_pattern' ]

Argumentos

• [ @job_id =] job_id
  Número de identificación del trabajo. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.

• [ @job_name = ] 'job_name'
  Nombre del trabajo. job_name es de tipo sysname y su valor predeterminado es NULL.

  [!NOTA] Se debe especificar job_id o job_name, pero no ambos.

• [ @job_aspect =] 'job_aspect'
  Atributo del trabajo que se va a mostrar. job_aspect es de tipo varchar(9), su valor predeterminado es NULL y puede tener uno de los siguientes valores.

  Valor	Descripción
  ALL	Información del aspecto del trabajo
  JOB	Información del trabajo
  SCHEDULES	Información de la programación
  STEPS	Información de los pasos del trabajo
  TARGETS	Información de los destinos

• [ @job_type =] 'job_type'
  Tipo de trabajos que se incluirán en el informe. job_type es de tipo varchar(12) y su valor predeterminado es NULL. job_type puede ser LOCAL o MULTI-SERVER.

• [ @owner_login_name =] 'login_name'
  Nombre del inicio de sesión del propietario del trabajo. login_name es de tipo sysname y su valor predeterminado es NULL.

• [ @subsystem =] 'subsystem'
  Nombre del subsistema. subsystem es de tipo nvarchar(40) y su valor predeterminado es NULL.

• [ @category_name =] 'category'
  Nombre de la categoría. category es de tipo sysname y su valor predeterminado es NULL.

• [ @enabled =] enabled
  Número que indica si se muestra información de los trabajos habilitados o los trabajos deshabilitados. enabled es de tipo tinyint y su valor predeterminado es NULL. 1 indica trabajos habilitados y 0 indica trabajos deshabilitados.

• [ @execution_status =] status
  Estado de ejecución de los trabajos. status es de tipo int, su valor predeterminado es NULL y puede tener uno de los siguientes valores.

  Valor	Descripción
  0	Devuelve sólo los trabajos que no están inactivos o suspendidos.
  1	En ejecución.
  2	En espera de subproceso.
  3	Entre reintentos.
  4	Inactivo.
  5	Suspendido.
  7	Realizando acciones de finalización.

• [ @date_comparator =] 'date_comparison'
  Operador de comparación que se utiliza en las comparaciones de date_created y date_modified. date_comparison es de tipo char(1) y puede ser =, < o >.

• [ @date_created =] date_created
  Fecha en la que se creó el trabajo. date_createdes de tipo datetime y su valor predeterminado es NULL.

• [ @date_last_modified =] date_modified
  Fecha en la que se modificó el trabajo por última vez. date_modified es de tipo datetime y su valor predeterminado es NULL.

• [ @description =] 'description_pattern'
  Descripción del trabajo. description_pattern es de tipo nvarchar(512) y su valor predeterminado es NULL. description_pattern puede incluir caracteres comodín de SQL Server para la coincidencia de patrón.

Conjuntos de resultados

Si no se especifica ningún argumento, sp_help_job devuelve este conjunto de resultados.

Si se especifica job_id o job_name, sp_help_job devuelve estos conjuntos de resultados adicionales para los pasos del trabajo, las programaciones del trabajo y los servidores de destino del trabajo.

Éste es el conjunto de resultados de los pasos del trabajo.

Éste es el conjunto de resultados de las programaciones del trabajo.

Éste es el conjunto de resultados de los servidores de destino del trabajo.

Permisos

De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse 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 más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole sólo pueden ver trabajos de los que sean propietarios. Los miembros de sysadmin, SQLAgentReaderRole y SQLAgentOperatorRole pueden ver todos los trabajos locales y multiservidor.

Valores de código de retorno

0 (correcto) o 1 (error)

Ejemplos

A. Mostrar información de todos los trabajos

Este ejemplo ejecuta el procedimiento sp_help_job sin parámetros para obtener la información de todos los trabajos actualmente definidos en la base de datos msdb.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B. Mostrar información de los trabajos que coinciden con un criterio específico

En el siguiente ejemplo se muestra información sobre el trabajo para los trabajos multiservidor que pertenecen a françoisa, donde el trabajo se habilita y ejecuta.

USE msdb ;
GO

EXEC dbo.sp_help_job 
   @job_type = N'MULTI-SERVER',
   @owner_login_name = N'françoisa',
   @enabled = 1,
   @execution_status = 1 ;
GO

C. Mostrar todos los aspectos de la información de un trabajo

En el siguiente ejemplo se muestran todos los aspectos de la información para el trabajo NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_help_job
    @job_name = N'NightlyBackups',
    @job_aspect = N'ALL' ;
GO

Vea también

Referencia

sp_add_job (Transact-SQL)
sp_delete_job (Transact-SQL)
sp_update_job (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Ayuda e información

Obtener ayuda sobre SQL Server 2005