sp_help_downloadlist (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Lista todas as linhas na tabela do sistema sysdownloadlist 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 = ] '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 retornar informações. job_id é uniqueidentifier, com um padrão 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 ambos não podem ser especificados.

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

Valor Descrição
DEFEITO Operação de servidor que solicita que o servidor de destino deserte do serviço Mestre SQLServerAgent .
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.
INSCREVER-SE NOVAMENTE 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 recarrega os detalhes do 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 especificado, o valor é interpretado como o valor de intervalo necessário e pode ser um valor de 10 a 28.800.
COMEÇAR 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 de um trabalho, não as etapas de trabalho ou agendamentos. É chamado automaticamente por sp_update_job.

[ @object_type = ] 'object_type' O tipo de objeto para o trabalho especificado. object_type é varchar(64), com um padrão de NULL. object_type pode ser JOB ou SERVER. Para obter mais informações sobre valores de object_typeválidos, 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 É se o trabalho deve reconhecer 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 para as quais todas as entradas feitas em ou após a data e hora especificadas devem ser incluídas no conjunto de resultados. date_posted é datetime, com um padrão de NULL.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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. No Microsoft SQL Server versão 7.0, esse é 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 para um objeto de trabalho ou 0x00 para um objeto de servidor) ou um valor de dados específico do 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 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

Procedimentos armazenados do sistema (Transact-SQL)