sp_help_downloadlist (Transact-SQL)

Artigo
06/18/2013

Lista todas as linhas da tabela de sistema sysdownloadlist para o trabalho fornecido, ou todas as linhas se nenhum trabalho for especificado.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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
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.
[ @job_name= ] 'job_name'
O nome do trabalho. job_name é sysname, com um padrão de NULL.

Observação

É necessário especificar job_id ou job_name, mas não é possível especificar ambos ao mesmo tempo.

Observação
É necessário especificar job_id ou job_name, mas não é possível especificar ambos ao mesmo tempo.

[ @operation= ] 'operation'
A operação válida para o trabalho especificado. operation é varchar(64), com um padrão de NULL, e pode ter um destes valores.

Valor	Descrição
DEFECT	A operação de servidor que solicita que o servidor de destino seja removido do serviço SQLSERVERAGENT Mestre.
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 detalhes de MSXOperator.
SET-POLL	Operação de servidor que define o intervalo, em segundos, para que os servidores de destino sondem o domínio multisservidor. Se for especificado, value é interpretado como o valor de intervalo necessário, podendo 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 somente as informações sysjobs de por um trabalho, não as etapas de trabalho ou agendas. É chamada 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 por ser JOB ou SERVER. Para obter mais informações sobre valores válidos de object_type, consulte sp_add_category (Transact-SQL).
[ @object_name= ] 'object_name'
O nome do objeto. object_name é sysname, com um padrão de NULL. Se object_type for JOB, object_nameserá o nome do trabalho. Se object_typefor SERVER, object_nameserá o nome do servidor.
[ @target_server= ] 'target_server'
O nome do servidor de destino. target_server é nvarchar(128), com um padrão de NULL.
[ @has_error= ] has_error
Especifica se o trabalho deve confirmar erros. has_error é tinyint, com um padrão de NULL que indica que nenhum erro deve ser confirmado. 1 indica que todos os erros devem ser confirmados.
[ @status= ] status
O status do trabalho. status é tinyint, com um valor 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 de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

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. No Microsoft SQL Server versão 7.0, este sempre é o nome do computador do servidor mestre (MSX).

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 de um objeto de trabalho ou 0x00 para um objeto de servidor) ou um valor de dados específico ao 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 pelo servidor de destino.

date_posted

datetime

Data em que a instrução foi postada na tabela.

date_downloaded

datetime

Data em que a instrução foi baixada pelo servidor de destino.

status

tinyint

Status do trabalho:

0 = Ainda não foi baixado

1 = Baixado com êxito.

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

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)

Compartilhar via