Ir para o conteúdo

Plugin de atualização de banco de dados (obsoleto) para grupos de agentes privados Jitterbit

Introdução

O plugin DB Update insere/atualiza em lote um banco de dados a partir de um arquivo, ou cria um arquivo de controle para executar o Oracle SQL Loader. O plugin DB Update suporta NVARCHAR2 e suporta o tipo de coluna CLOB ao usar Oracle.

Este plugin pode ser associado apenas a grupos de agentes privados e não está disponível nos grupos de agentes de nuvem Jitterbit.

Importante

Os plugins fornecidos pelo Jitterbit estão obsoletos. Veja Deprecation and support em Plugins.

Baixe e adicione o plugin

O plugin DB Update deve ser baixado no link fornecido abaixo e adicionado à organização.

Associe o plugin a um grupo de agentes

O plugin DB Update deve ser associado a um grupo de agentes privados para tornar o plugin disponível em todos os agentes do grupo.

Defina variáveis e use o plugin em um projeto

Consulte estes tópicos para obter informações sobre o uso de plugins em um projeto:

O plugin DB Update pode executar uma inserção/atualização em lote ou uma replicação usando as variáveis listados abaixo.

Executar inserção/atualização em lote

Para executar uma inserção/atualização em lote, defina a variável jitterbit.plugin.DbUpdate.UseOracleSqlldr para false ou nulo.

O plugin lê dados do arquivo de destino e insere/atualiza uma tabela de banco de dados. O arquivo de destino é assumido como estando no formato CSV com codificação UTF-8.

O log do plugin pode ser encontrado em <JITTERBIT_HOME>/log/plugin/. Exemplo de nome de arquivo de log: DbUpdate_Account_2013_03_11.log.

Executar replicação

Para executar uma replicação:

  1. Defina a variável jitterbit.plugin.DbUpdate.UseOracleSqlldr para true.
  2. Defina a variável jitterbit.plugin.DbUpdate.ControlFile para criar os nomes dos arquivos:
    • O nome do arquivo de controle é concatenado do valor da variável + .ctrl.
    • O nome do arquivo de dados é concatenado do valor da variável + .data.
    • O nome do arquivo de log SQLLDR é concatenado do valor da variável + .log.

O processo pode gerar uma sequência de respostas da consultar/queryMore.

O plugin será executado no arquivo de destino no final da transformação de resposta.

Na primeira vez que o plugin for executado, ele copiará o cabeçalho (jitterbit.plugin.DbUpdate.ControlHeader) para o arquivo de controle, e o arquivo de destino para o arquivo de dados. Em execuções subsequentes, o arquivo de destino será anexado ao arquivo de dados.

Variáveis

Nome Tipo Obrigatório Descrição
jitterbit.plugin.DbUpdate.ColumnName_list String Opcional

Normalmente todos os campos no objeto Salesforce são transferidos para a tabela do banco de dados, e a chave primária da tabela é "ID". Para pular alguns campos ou usar outras chaves primárias, você pode usar esta variável global opcional.

Neste caso, a coluna de chave primária na lista deve anexar o rótulo "(PR)", então a lista ficaria assim:

Id(PR),Name, . . . |

jitterbit.plugin.DbUpdate.ControlHeader String Opcional O cabeçalho a ser copiado para o arquivo de controle.
jitterbit.plugin.DbUpdate.ControlFile String Opcional

Para uma réplica:

  • O nome do arquivo de controle é concatenado do valor da variável + .ctrl.
  • O nome do arquivo de dados é concatenado do valor da variável + .data.
  • O nome do arquivo de log SQLLDR é concatenado do valor da variável + .log.

jitterbit.plugin.DbUpdate.DbGuid String Opcional O GUID do banco de dados.
jitterbit.plugin.DbUpdate.DebugMode String Opcional Defina como qualquer valor para habilitar o modo de depurar. Quando o modo de depurar é habilitado, o registro é adicionado.
jitterbit.plugin.DbUpdate.SqlLdrAuth String Opcional Autenticação do Oracle SQL Loader.
jitterbit.plugin.DbUpdate.SqlLdrPath String Opcional O caminho do Oracle SQL Loader.
jitterbit.plugin.DbUpdate.TableName String Opcional Esta variável pode incluir o nome do esquema. Por exemplo, "OWNER:ACCOUNT".

Nota

O nome da coluna de chave primária da tabela do banco de dados deve ser "ID".

jitterbit.plugin.DbUpdate.UseOracleSqlldr Boolean Opcional

Para uma réplica, defina o valor como true.

Para uma inserção/atualização, defina o valor como false ou null.

O valor padrão é false.