Tarefa Transferir Trabalhos

  • Artigo

Aplica-se a:SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Transferir Trabalhos transfere um ou mais trabalhos do SQL Server Agent entre instâncias do SQL Server.

A tarefa Transferir Trabalhos pode ser configurada para transferir todos os trabalhos ou só os trabalhos especificados. Você também pode indicar se os trabalhos transferidos são habilitados no destino.

Os trabalhos a ser transferidos já podem existir no destino. A tarefa Transferir Trabalhos pode ser configurada para manipular os trabalhos existentes dos modos a seguir:

  • Substituir os trabalhos existentes.

  • Interromper a tarefa quando houver trabalhos duplicados.

  • Ignorar trabalhos duplicados.

No tempo de execução, a tarefa Transferir Trabalhos conecta-se aos servidores de origem e de destino usando um ou dois gerenciadores de conexões SMO. O gerenciador de conexões SMO é configurado separadamente da tarefa Transferir Trabalhos e depois é referenciado na tarefa Transferir Trabalhos. O gerenciador de conexões SMO especifica o servidor e o modo de autenticação a ser usado ao acessar o servidor. Para obter mais informações, consulte SMO Connection Manager.

Transferindo trabalhos entre instâncias do SQL Server

A tarefa Transferir Trabalhos dá suporte a uma origem e a um destino do SQL Server . Não há nenhuma restrição quanto à versão a ser usada como origem ou destino.

Eventos

A tarefa Transferir Trabalhos gera um evento de informação com o número de trabalhos transferidos e um evento de aviso quando um trabalho é substituído. A tarefa não informa o progresso incremental da transferência de trabalhos; informa só 0% e 100% concluídos.

Valor de execução

O valor de execução, definido na propriedade ExecutionValue da tarefa retorna o número de trabalhos que são transferidos. Ao atribuir uma variável definida pelo usuário à propriedade ExecValueVariable da tarefa Transferir Trabalhos, informações sobre a transferência de trabalhos podem se tornar disponíveis a outros objetos no pacote. Para obter mais informações, confira Variáveis do Integration Services (SSIS) e Usar variáveis em pacotes.

Entradas de log

A tarefa Transferir Trabalhos inclui as seguintes entradas de log personalizadas:

  • TransferJobsTaskStarTransferringObjects Essa entrada de log informa que a transferência foi iniciada. A entrada do log contém a hora de início.

  • TransferJobsTaskFinishedTransferringObjects Essa entrada de log informa que a transferência foi concluída. A entrada do log contém a hora de término.

Além disso, uma entrada de log para o evento OnInformation informa o número de trabalhos que foram transferidos e uma entrada de log para o evento OnWarning é gravada para cada trabalho no destino que for substituído.

Segurança e permissões

Para transferir trabalhos, o usuário deve ser membro da função de servidor fixa sysadmin ou de uma das funções de banco de dados fixas Agent do SQL Server no banco de dados msdb em ambas as instâncias de origem e de destino do SQL Server.

Configuração da tarefa Transferir Trabalhos

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique no tópico a seguir:

Para obter informações sobre como definir essas propriedades programaticamente, clique no tópico a seguir:

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, clique no tópico a seguir:

Editor da Tarefa Transferir Trabalhos (página Geral)

Use a página Geral da caixa de diálogo do Editor da Tarefa Transferir Trabalhos para nomear e descrever a tarefa Transferir Trabalhos.

Observação

Somente os membros da função de servidor fixa sysadmin ou uma das funções de banco de dados fixas do SQL Server Agent no servidor de destino podem criar trabalhos com êxito. Para acessar trabalhos no servidor de origem, os usuários devem ser membros pelo menos da função de banco de dados fixa SQLAgentUserRole . Para obter mais informações sobre as funções de banco de dados fixas do SQL Server Agent e suas permissões, consulte Funções de banco de dados fixas do SQL Server Agent.

Opções

Nome
Digite um nome exclusivo para a tarefa Transferir Trabalhos. Esse nome é usado como rótulo no ícone de tarefa.

Observação

Os nomes das tarefas devem ser exclusivos em um pacote.

Descrição
Digite uma descrição para a tarefa Transferir Trabalhos.

Editor da Tarefa Transferir Trabalhos (página Trabalhos)

Use a página Trabalhos da caixa de diálogo Editor da Tarefa de Transferir Trabalhos para especificar as propriedades para cópia de um ou mais trabalhos de SQL Server Agent de uma instância de SQL Server para outra.

Observação

Para acessar trabalhos no servidor de origem, é necessário que os usuários sejam membros pelo menos da função do banco de dados fixa SQLAgentUserRole no servidor. Para criar trabalhos no servidor de destino com êxito, é necessário que o usuário seja um membro da função de servidor fixa sysadmin ou uma das funções de banco de dados fixas do SQL Server Agent. Para obter mais informações sobre as funções de banco de dados fixas do SQL Server Agent e suas permissões, consulte Funções de banco de dados fixas do SQL Server Agent.

Opções

SourceConnection
Selecione um gerenciador de conexões SMO na lista ou clique em <Nova conexão...> para criar uma nova conexão com o servidor de origem.

DestinationConnection
Selecione um gerenciador de conexões do SMO na lista ou clique em <Nova conexão...> para criar uma conexão com o servidor de destino.

TransferAllJobs
Selecione se a tarefa deve copiar todas ou apenas os trabalhos de Agente SQL Server especificados do servidor de origem para o servidor de destino.

As opções desta propriedade estão listadas na seguinte tabela:

Valor Descrição
Verdadeiro Copia todas as tarefas.
Falso Copia apenas os trabalhos especificados.

JobsList
Clique no botão Procurar (...) para selecionar os trabalhos a serem copiados. Pelo menos um trabalho deve ser selecionado.

Observação

Especifique a SourceConnection antes de selecionar trabalhos para copiar.

A opção JobsList não estará disponível quando TransferAllJobs for definido como True.

IfObjectExists
Selecione como a tarefa deve tratar trabalhos que tenham o mesmo nome já existente no servidor de destino.

As opções desta propriedade estão listadas na seguinte tabela:

Valor DESCRIÇÃO
FailTask A tarefa irá falhar se já existirem trabalhos com o mesmo nome no servidor de destino.
Overwrite A tarefa irá substituir trabalhos de mesmo nome no servidor de destino.
Ignorar A tarefa irá ignorar os trabalhos de mesmo nome que existem no servidor de destino.

EnableJobsAtDestination
Selecione se os trabalhos copiados para o servidor de destino devem ser habilitados.

As opções desta propriedade estão listadas na seguinte tabela:

Valor Descrição
Verdadeiro Habilita trabalhos no servidor de destino.
Falso Desabilita trabalhos no servidor de destino.

Consulte Também

Tarefas do Integration Services
Fluxo de Controle