Saltar al contenido

Plugin de actualización de DB (obsoleto) para grupos de agentes privados de Jitterbit

Introducción

El plugin de actualización de DB inserta/actualiza en lotes una base de datos desde un archivo, o crea un archivo de control para ejecutar Oracle SQL Loader. El plugin de actualización de DB admite NVARCHAR2 y el tipo de columna CLOB al usar Oracle.

Este plugin solo se puede asociar con grupos de agentes privados y no está disponible en los grupos de agentes en la nube de Jitterbit.

Importante

Los plugins proporcionados por Jitterbit están obsoletos.

Descargar y agregar el plugin

El plugin de actualización de DB debe descargarse en el enlace proporcionado a continuación y agregarse a la organización.

Asociar el plugin con un grupo de agentes

El plugin de actualización de DB debe asociarse con un grupo de agentes privados para que el plugin esté disponible en todos los agentes del grupo.

Establecer variables y usar el plugin en un proyecto

Consulte estos temas para obtener información sobre el uso de plugins en un proyecto:

El plugin de actualización de DB puede realizar una inserción/actualización en lote o una replicación utilizando las variables que se enumeran a continuación.

Realizar inserción/actualización en lote

Para realizar una inserción/actualización en lote, establezca la variable jitterbit.plugin.DbUpdate.UseOracleSqlldr en false o nulo.

El plugin lee datos del archivo de destino e inserta/actualiza una tabla de base de datos. Se asume que el archivo de destino está en formato CSV con codificación UTF-8.

El registro del plugin se puede encontrar en <JITTERBIT_HOME>/log/plugin/. Nombre de ejemplo del archivo de registro: DbUpdate_Account_2013_03_11.log.

Realizar replicación

Para realizar una replicación:

  1. Establecer la variable jitterbit.plugin.DbUpdate.UseOracleSqlldr en true.
  2. Establecer la variable jitterbit.plugin.DbUpdate.ControlFile para crear los nombres de archivo:
    • El nombre del archivo de control se concatena a partir del valor de la variable + .ctrl.
    • El nombre del archivo de datos se concatena a partir del valor de la variable + .data.
    • El nombre del archivo de registro de SQLLDR se concatena a partir del valor de la variable + .log.

El proceso puede generar una secuencia de respuestas de query/queryMore.

El plugin se ejecutará en el archivo de destino al final de la transformación de respuesta.

La primera vez que se ejecute el plugin, copiará el encabezado (jitterbit.plugin.DbUpdate.ControlHeader) al archivo de control y el archivo de destino al archivo de datos. En ejecuciones posteriores, el archivo de destino se añadirá al archivo de datos.

Variables

Nombre Tipo Requerido Descripción
jitterbit.plugin.DbUpdate.ColumnName_list Cadena Opcional

Normalmente, todos los campos en el objeto de Salesforce se transfieren a la tabla de la base de datos, y la clave primaria de la tabla es "ID". Para omitir algunos campos o usar otras claves primarias, se puede utilizar esta variable global opcional.

En este caso, la columna de clave primaria en la lista debe agregar la etiqueta "(PR)", por lo que la lista se vería como sigue:

Id(PR),Name, . . . |

jitterbit.plugin.DbUpdate.ControlHeader Cadena Opcional El encabezado que se copiará en el archivo de control.
jitterbit.plugin.DbUpdate.ControlFile Cadena Opcional

Para una replicación:

  • El nombre del archivo de control se concatena a partir del valor de la variable + .ctrl.
  • El nombre del archivo de datos se concatena a partir del valor de la variable + .data.
  • El nombre del archivo de registro de SQLLDR se concatena a partir del valor de la variable + .log.

jitterbit.plugin.DbUpdate.DbGuid Cadena Opcional El GUID de la base de datos.
jitterbit.plugin.DbUpdate.DebugMode Cadena Opcional Establecer en cualquier valor para habilitar el modo de depuración. Cuando el modo de depuración está habilitado, se agrega registro.
jitterbit.plugin.DbUpdate.SqlLdrAuth Cadena Opcional La autenticación de Oracle SQL Loader.
jitterbit.plugin.DbUpdate.SqlLdrPath Cadena Opcional La ruta de Oracle SQL Loader.
jitterbit.plugin.DbUpdate.TableName Cadena Opcional Esta variable puede incluir el nombre del esquema. Por ejemplo, "OWNER:ACCOUNT".

Nota

El nombre de la columna de clave primaria de la tabla de la base de datos debe ser "ID".

jitterbit.plugin.DbUpdate.UseOracleSqlldr Booleano Opcional

Para una replicación, establecer el valor en true.

Para una inserción/actualización, establecer el valor en false o null.

El valor predeterminado es false.