DB Update¶

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 oferece suporte a NVARCHAR2 e ao 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 (veja Adicionar novos plugins em Personalizações > Plug-ins).

Atualização do BD (.ZIP)

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 (consulte Associar grupos de agentes em Personalizações > Plug-ins).

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:

Plugins (Cloud Studio)
Plug-ins (Design Studio)

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

Executar Inserção/atualização em Lote¶

Para realizar 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:

Defina a variável jitterbit.plugin.DbUpdate.UseOracleSqlldr para true.
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 da 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`	Corda	Opcional	Normalmente todos os campos do 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`	Corda	Opcional	O cabeçalho a ser copiado no 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`	Corda	Opcional	Defina qualquer valor para ativar o modo de depurar. Quando o modo de depurar está ativado, o log é adicionado.
`jitterbit.plugin.DbUpdate.SqlLdrAuth`	Corda	Opcional	A autenticação do Oracle SQL Loader.
`jitterbit.plugin.DbUpdate.SqlLdrPath`	Corda	Opcional	O caminho do carregador Oracle SQL.
`jitterbit.plugin.DbUpdate.TableName`	Corda	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`.