sp_help_downloadlist (Transact-SQL)

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

Convenções de 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 serão retornadas. job_id é uniqueidentifier, com um padrão NULL.

• [ @job_name= ] 'job_name'
  O nome do trabalho. job_name é sysname, com um padrão NULL.

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

• [ @operation= ] 'operation'
  A operação válida do trabalho especificado. operation é varchar(64), com um padrão NULL, e pode ser 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 multiservidor. 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 multiservidor. 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 multiservidor. Como esta é uma operação cara, execute-a de maneira limitada e infreqüente.
  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 de objeto do trabalho especificado. object_type é varchar(64), com um padrão NULL. object_type pode 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 NULL. Se object_type for JOB, object_name será o nome do trabalho. Se object_type for SERVER, object_name será o nome do servidor.

• [ @target_server= ] 'target_server'
  O nome do servidor de destino. target_server é nvarchar(128), com um padrão NULL.

• [ @has_error= ] has_error
  Especifica se o trabalho deve confirmar erros. has_error é tinyint, com um padrão 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 NULL.

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

Valores de 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, 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 de execução deste 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)