sp_help_job (Transact-SQL)

Se aplica a:SQL Server

Devuelve información sobre los trabajos que usa Agente SQL Server para realizar actividades automatizadas en SQL Server.

Convenciones de sintaxis de Transact-SQL

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 uniqueidentifier, con un valor predeterminado de NULL.

[ @job_name = ] 'job_name' Nombre del trabajo. job_name es sysname, con un valor predeterminado de NULL.

[ @job_aspect = ] 'job_aspect' Atributo de trabajo que se va a mostrar. job_aspect es varchar(9), con un valor predeterminado de NULL y puede ser uno de estos valores.

[ @job_type = ] 'job_type' Tipo de trabajos que se van a incluir en el informe. job_type es varchar(12), con un valor predeterminado de NULL. job_type puede ser LOCAL o MULTI-SERVER.

[ @owner_login_name = ] 'login_name' Nombre de inicio de sesión del propietario del trabajo. login_name es sysname, con un valor predeterminado de NULL.

[ @subsystem = ] 'subsystem' Nombre del subsistema. el subsistema es nvarchar(40), con un valor predeterminado de NULL.

[ @category_name = ] 'category' Nombre de la categoría. category es sysname, con un valor predeterminado de NULL.

[ @enabled = ] enabled Número que indica si se muestra información para trabajos habilitados o trabajos deshabilitados. enabled es tinyint, con un valor predeterminado de NULL. 1 indica trabajos habilitados y 0 indica trabajos deshabilitados.

[ @execution_status = ] status Estado de ejecución de los trabajos. status es int, con un valor predeterminado de NULL y puede ser uno de estos valores.

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

[ @date_created = ] date_created Fecha en que se creó el trabajo. date_createdes datetime, con un valor predeterminado de NULL.

[ @date_last_modified = ] date_modified Fecha en la que se modificó por última vez el trabajo. date_modified es datetime, con un valor predeterminado de NULL.

[ @description = ] 'description_pattern' Descripción del trabajo. description_pattern es nvarchar(512), con un valor predeterminado de NULL. description_pattern puede incluir los caracteres comodín SQL Server para la coincidencia de patrones.

Valores de código de retorno

0 (correcto) o 1 (error)

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 de trabajo, las programaciones de 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 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 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 los trabajos que poseen. Los miembros de sysadmin, SQLAgentReaderRole y SQLAgentOperatorRole pueden ver todos los trabajos locales y multiservidor.

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  

Consulte también

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