sp_help_downloadlist (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Lista todas as linhas na tabela do sysdownloadlist sistema para o trabalho fornecido ou todas as linhas se nenhum trabalho for especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

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'

O número de identificação do trabalho para o qual as informações devem ser retornadas. @job_id é uniqueidentifier, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@job_name [ = ] N'job_name'

O nome do trabalho. @job_name é sysname, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@operation [ = ] 'operação'

A operação válida para o trabalho especificado. @operation é varchar(64) e pode ser um desses valores.

Valor Descrição
DEFECT Operação de servidor que solicita que o servidor de destino deserte do serviço Master SQL Server Agent.
DELETE Operação de trabalho que remove um trabalho inteiro.
INSERT Operação de trabalho que insere um trabalho inteiro ou atualiza um trabalho existente. Esta operação inclui todas as etapas de trabalho e agendas, se aplicável.
RE-ENLIST Operação de servidor que faz com que o servidor de destino reenvie suas informações de inscrição, incluindo o intervalo de sondagem e o fuso horário do domínio multisservidor. O servidor de destino também baixa novamente os MSXOperator detalhes.
SET-POLL Operação de servidor que define o intervalo, em segundos, para que os servidores de destino sondem o domínio multisservidor. Se especificado, @value é interpretado como o valor de intervalo necessário e pode ser um valor de 10 a 28.800.
START Operação de trabalho que solicita o início da execução do trabalho.
STOP Operação de trabalho que solicita a parada da execução do trabalho.
SYNC-TIME Operação de servidor que faz com que o servidor de destino sincronize seu relógio de sistema com o domínio multisservidor. Como esta é uma operação cara, execute-a de maneira limitada e infrequente.
UPDATE Operação de trabalho que atualiza apenas as informações de sysjobs um trabalho, não as etapas ou agendamentos do trabalho. É chamado automaticamente por sp_update_job.

@object_type [ = ] 'object_type'

O tipo do objeto para o trabalho especificado. @object_type é varchar(64), com um padrão de NULL. @object_type pode ser ou JOB SERVER. Para obter mais informações sobre valores @object_typeválidos, consulte sp_add_category.

[ @object_name = ] N'object_name'

O nome do objeto. @object_name é sysname, com um padrão de NULL. Se @object_type for JOB, @object_name é o nome do trabalho. Se @object_type for SERVER, @object_name é o nome do servidor.

@target_server [ = ] N'target_server'

O nome do servidor de destino. @target_server é sysname, com um padrão de NULL.

@has_error [ = ] has_error

Especifica se o trabalho deve reconhecer erros. @has_error é tinyint, com um padrão de NULL, o que indica que nenhum erro deve ser reconhecido. 1 indica que todos os erros devem ser reconhecidos.

@status [ = ] status

O status do trabalho. @status é tinyint, com um padrão de NULL.

@date_posted [ = ] date_posted

A data e a hora a partir das quais todas as entradas feitas na data e hora especificadas ou depois devem ser incluídas no conjunto de resultados. @date_posted é datetime, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
instance_id int Número de identificação inteiro exclusivo da instrução.
source_server nvarchar(30) Nome do computador do servidor do qual a instrução veio.
operation_code nvarchar(4000) Código de operação da instrução.
object_name sysname Objeto afetado pela instrução.
object_id uniqueidentifier Número de identificação do objeto afetado pela instrução (job_id para um objeto de trabalho ou 0x00 para um objeto de servidor) ou um valor de dados específico para o operation_code.
target_server nvarchar(30) Servidor de destino pelo qual esta instrução deve ser baixada.
error_message nvarchar(1024) Mensagem de erro (se houver) do servidor de destino se ele encontrou um problema ao processar esta instrução.

Observação: qualquer mensagem de erro bloqueia todos os downloads adicionais do servidor de destino.
date_posted datetime Data em que a instrução foi postada na tabela.
date_downloaded datetime Data em que o servidor de destino baixou a instrução.
status tinyint Status do trabalho:

0 = Ainda não baixado
1 = Baixado com sucesso.

Permissões

As permissões para executar esse procedimento usam como padrão membros da função de servidor fixa sysadmin .

Exemplos

O exemplo a seguir lista as linhas no sysdownloadlist para o trabalho 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

Conteúdo relacionado