Ir para o conteúdo

Plugin de Atualização de DB (obsoleto) para grupos de agentes privados do Jitterbit

Introdução

O plugin de Atualização de DB 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 de Atualização de DB suporta NVARCHAR2 e o tipo de coluna CLOB ao usar o Oracle.

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

Importante

Plugins fornecidos pelo Jitterbit são obsoletos.

Baixar e adicionar o plugin

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

Associar o plugin a um grupo de agentes

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

Definir variáveis e usar o plugin em um projeto

Consulte estes tópicos para obter informações sobre como usar plugins em um projeto:

O plugin de Atualização de DB pode realizar uma inserção/atualização em lote ou uma replicação usando as variáveis listadas abaixo.

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

Para realizar uma inserção/atualização em lote, defina a variável jitterbit.plugin.DbUpdate.UseOracleSqlldr como false ou nula.

O plugin lê dados do arquivo de destino e insere/atualiza uma tabela de banco de dados. O arquivo de destino deve estar 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.

Realizar replicação

Para realizar uma replicação:

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

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

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

Na primeira vez que o plugin é 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 da chave primária na lista deve ter 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 replicação:

  • O nome do arquivo de controle é concatenado a partir do valor da variável + .ctrl.
  • O nome do arquivo de dados é concatenado a partir do valor da variável + .data.
  • O nome do arquivo de log do SQLLDR é concatenado a partir 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 depuração. Quando o modo de depuração está habilitado, o registro é adicionado.
jitterbit.plugin.DbUpdate.SqlLdrAuth String Opcional A 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 da chave primária da tabela do banco de dados deve ser "ID".

jitterbit.plugin.DbUpdate.UseOracleSqlldr Boolean Opcional

Para uma replicação, defina o valor como true.

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

O valor padrão é false.