Compartilhar via


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.

Ícone de vínculo de tópicoConvençõ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çãoObservaçã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çãoObservaçã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