sp_help_downloadlist (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Enumera todas las filas de la tabla del sysdownloadlist sistema 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 = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'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.

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

[ @job_name = ] N'job_name'

Nombre del trabajo. @job_name es sysname, con un valor predeterminado de NULL.

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

[ @operation = ] 'operation'

Operación válida del trabajo especificado. @operation es varchar(64) y puede ser uno de estos valores.

Valor Descripción
DEFECT Operación del servidor que solicita al servidor de destino que desperfecte del servicio master Agente SQL Server.
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 MSXOperator detalles.
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 y puede ser un valor de 10 a 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 actualiza solo la sysjobs información de un trabajo, no los pasos o programaciones del trabajo. Llama automáticamente a sp_update_job.

[ @object_type = ] 'object_type'

Tipo de objeto del 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, consulte sp_add_category.

[ @object_name = ] N'object_name'

El nombre del objeto. @object_name es sysname, con un valor predeterminado de NULL. Si @object_type es JOB, @object_name es el nombre del trabajo. Si @object_type es SERVER, @object_name es el nombre del servidor.

[ @target_server = ] N'target_server'

El nombre del servidor de destino. @target_server es sysname, con un valor predeterminado de NULL.

[ @has_error = ] has_error

Especifica si el trabajo debe confirmar errores. @has_error es tinyint, con un valor predeterminado de NULL, que indica que no se debe confirmar ningún error. 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 desde las que se van a presentar las entradas 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 (erróneo).

Conjunto 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.
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 en el que se debe 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 = Todavía no descargado
1 = Se ha 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

Contenido relacionado