DB Update¶

Introdução¶

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

Este plug-in pode ser associado apenas a Grupos de Agentes Privados e não está disponível nos Jitterbit Grupos de Agentes em Nuvem.

Importante

Os plug-ins fornecidos pelo Jitterbit estão obsoletos. Consulte Deprecação e suporte em Plugins.

Baixe e Adicione o Plug-in¶

O plug-in DB Update deve ser baixado no link fornecido abaixo e adicionado à organização (consulte Adicionar novos plug-ins em Customizações > Plug-ins).

Atualização do banco de dados (.ZIP)

Associar o Plug-in a um Grupo de Agentes¶

O plug-in DB Update deve estar associado a um Grupo de Agentes Privados para disponibilizar o plug-in em todos os agentes do grupo (consulte Associar grupos de Agente em Customizações > Plug-ins).

Definir Variáveis e Usar o Plug-in em um Projeto¶

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

Plugins (Cloud Studio)
Plugins (Design Studio)

O plug-in DB Update pode executar uma inserção/atualização em lote ou uma réplica usando as variáveis listado 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 plug-in lê dados do arquivo de destino e insere/atualiza uma tabela de banco de dados. Supõe-se que o arquivo de destino esteja no formato CSV com codificação UTF-8.

O registro do plug-in pode ser encontrado em <JITTERBIT_HOME>/log/plugin/. Nome do arquivo de log de exemplo: 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 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 SQLLDR é concatenado a partir do valor da variável + .log.

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

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

Na primeira vez que o plug-in 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. Nas 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. Nesse 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`	Corda	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 SQLLDR é concatenado a partir do valor da variável + `.log`.
`jitterbit.plugin.DbUpdate.DbGuid`	Corda	Opcional	O GUID do banco de dados.
`jitterbit.plugin.DbUpdate.DebugMode`	Corda	Opcional	Defina como qualquer valor para habilitar 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 Oracle SQL Loader.
`jitterbit.plugin.DbUpdate.TableName`	Corda	Opcional	Essa 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`	Booleano	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`.