sp_help_downloadlist (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Enumera todas las filas de la tabla del sistema sysdownloadlist para el trabajo proporcionado o todas las filas si no se especifica ningún trabajo.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }   
     [ , [ @operation = ] 'operation' ]   
     [ , [ @object_type = ] 'object_type' ]   
     [ , [ @object_name = ] 'object_name' ]   
     [ , [ @target_server = ] 'target_server' ]   
     [ , [ @has_error = ] has_error ]   
     [ , [ @status = ] status ]   
     [ , [ @date_posted = ] date_posted ]

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.

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

Nota

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

[ @operation = ] 'operation' Operación válida para el trabajo especificado. operation es varchar(64), con un valor predeterminado de NULL y puede ser uno de estos valores.

Value Descripción
DEFECTO Operación de servidor que solicita al servidor de destino que se desperfecte del servicio Master SQLServerAgent .
DELETE Operación de trabajo que quita un trabajo completo.
INSERT Operación de trabajo que inserta un trabajo completo o actualiza un trabajo existente. Esta operación incluye todos los pasos y programaciones del trabajo, si corresponde.
RE-ENLIST Operación del servidor que hace que el servidor de destino vuelva a enviar la información de alta, incluidos el intervalo de sondeo y la zona horaria del dominio multiservidor. El servidor de destino también vuelve a descargar los detalles de MSXOperator .
SET-POLL Operación del servidor que establece el intervalo, en segundos, con el que los servidores de destino sondean el dominio multiservidor. Si se especifica, el valor se interpreta como el valor de intervalo necesario y puede ser un valor de 10 a 28 800.
EMPEZAR Operación de trabajo que solicita el inicio de la ejecución del trabajo.
PARADA Operación de trabajo que solicita la detención de la ejecución del trabajo.
SYNC-TIME Operación de servidor que hace que el servidor de destino sincronice su reloj del sistema con el dominio multiservidor. Como ésta es una operación muy costosa, ejecútela de forma limitada, con poca frecuencia.
UPDATE Operación de trabajo que actualiza solo la información de sysjobs de un trabajo, no los pasos o programaciones del trabajo. Se llama automáticamente por sp_update_job.

[ @object_type = ] 'object_type' Tipo de objeto para el trabajo especificado. object_type es varchar(64), con un valor predeterminado de NULL. object_type puede ser JOB o SERVER. Para obtener más información sobre los valores de object_typeválidos, vea sp_add_category (Transact-SQL).

[ @object_name = ] 'object_name' Nombre del objeto. object_name es sysname, con un valor predeterminado de NULL. Si object_type es JOB, object_namees el nombre del trabajo. Si object_typees SERVER, object_namees el nombre del servidor.

[ @target_server = ] 'target_server' Nombre del servidor de destino. target_server es nvarchar(128), con un valor predeterminado de NULL.

[ @has_error = ] has_error Es si el trabajo debe confirmar errores. has_error es tinyint, con un valor predeterminado de NULL, que indica que no se deben confirmar errores. 1 indica que se deben confirmar todos los errores.

[ @status = ] status Estado del trabajo. status es tinyint, con un valor predeterminado de NULL.

[ @date_posted = ] date_posted Fecha y hora para las que todas las entradas realizadas en o después de la fecha y hora especificadas deben incluirse en el conjunto de resultados. date_posted es datetime, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de la columna Tipo de datos Descripción
instance_id int Número de identificación entero único de la instrucción.
source_server nvarchar(30) Nombre de equipo del servidor del que proviene la instrucción. En Microsoft SQL Server versión 7.0, siempre es el nombre de equipo del servidor maestro (MSX).
operation_code nvarchar(4000) Código de operación de la instrucción.
object_name sysname Objeto afectado por la instrucción.
object_id uniqueidentifier Número de identificación del objeto afectado por la instrucción (job_id para un objeto de trabajo o 0x00 para un objeto de servidor) o un valor de datos específico del operation_code.
target_server nvarchar(30) Servidor de destino que va a descargar esta instrucción.
error_message nvarchar(1024) Mensaje de error (si existe) del servidor de destino si se encontró algún problema al procesar la instrucción.

Nota: Cualquier mensaje de error bloquea todas las descargas adicionales del servidor de destino.
date_posted datetime Fecha en que la instrucción se envió a la tabla.
date_downloaded datetime Fecha en que el servidor de destino descargó la instrucción.
status tinyint Estado del trabajo:

0 = Aún no descargado

1 = Descargado correctamente.

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros del rol fijo de servidor sysadmin .

Ejemplos

En el siguiente ejemplo se muestran las filas de sysdownloadlist para el trabajo NightlyBackups.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_downloadlist  
    @job_name = N'NightlyBackups',  
    @operation = N'UPDATE',   
    @object_type = N'JOB',   
    @object_name = N'NightlyBackups',  
    @target_server = N'SEATTLE2',   
    @has_error = 1,   
    @status = NULL,   
    @date_posted = NULL ;  
GO

Consulte también

Procedimientos almacenados del sistema (Transact-SQL)