sp_help_downloadlist (Transact-SQL)

Enumera todas las filas de la tabla del sistema sysdownloadlist relativas al trabajo especificado 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 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.

• [ @operation= ] 'operation'
  Operación válida del trabajo especificado. operation es de tipo varchar(64), su valor predeterminado es NULL y puede tener uno de estos valores.

  Valor	Descripción
  DEFECT	Operación del servidor que solicita que se dé de baja el servidor de destino en el servicio SQLServerAgent principal.
  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, value se interpreta como el valor de intervalo necesario; puede ser un valor entre 10 y 28.800.
  START	Operación de trabajo que solicita el inicio de la ejecución del trabajo.
  STOP	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 sólo actualiza la información de sysjobs de un trabajo, no los pasos ni la programación del trabajo. sp_update_job llama a esta operación automáticamente.

• [ @object_type= ] 'object_type'
  Tipo de objeto del trabajo especificado. object_type es de tipo varchar(64) y su valor predeterminado es NULL. object_type puede ser JOB o SERVER. Para obtener más información sobre valores válidos de object_type, vea sp_add_category (Transact-SQL).

• [ @object_name= ] 'object_name'
  Nombre del objeto. object_name es de tipo sysname y su valor predeterminado es 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 de tipo nvarchar(128) y su valor predeterminado es NULL.

• [ @has_error= ] has_error
  Indica si el trabajo tiene que reconocer errores. has_error es de tipo tinyint y su valor predeterminado es NULL, lo que indica que no se deben reconocer errores. 1 indica que se deben reconocer todos los errores.

• [ @status= ] status
  Estado del trabajo. status es de tipo tinyint y su valor predeterminado es NULL.

• [ @date_posted= ] date_posted
  Fecha y hora desde las que se van a presentar las entradas en el conjunto de resultados. date_posted es de tipo datetime y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de 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 MicrosoftSQL Server, versión 7.0, es siempre 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 de 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 las posteriores descargas 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 = Todavía sin descargar 1 = Descargado correctamente

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros de la función fija 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

Vea también

Referencia

Procedimientos almacenados del sistema (Transact-SQL)