Compartir a través de


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.

Icono de vínculo a temasConvenciones 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.

NotaNota
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