Zum Inhalt springen

DB Update-Plugin (veraltet) für Jitterbit private Agentengruppen

Einführung

Das DB Update-Plugin führt Batch-Einfügungen/Aktualisierungen in eine Datenbank aus einer Datei durch oder erstellt eine Steuerdatei, um den Oracle SQL Loader auszuführen. Das DB Update-Plugin unterstützt NVARCHAR2 und den CLOB-Spaltentyp bei der Verwendung von Oracle.

Dieses Plugin kann nur mit privaten Agentengruppen verknüpft werden und ist nicht in den Jitterbit-Cloud-Agentengruppen verfügbar.

Wichtig

Von Jitterbit bereitgestellte Plugins sind veraltet.

Plugin herunterladen und hinzufügen

Das DB Update-Plugin muss über den unten angegebenen Link heruntergeladen und der Organisation hinzugefügt werden.

Plugin mit einer Agentengruppe verknüpfen

Das DB Update-Plugin muss mit einer privaten Agentengruppe verknüpft werden, um das Plugin auf allen Agenten in der Gruppe verfügbar zu machen.

Variablen festlegen und das Plugin in einem Projekt verwenden

Beziehen Sie sich auf diese Themen für Informationen zur Verwendung von Plugins in einem Projekt:

Das DB Update-Plugin kann eine Batch-Einfügung/Aktualisierung oder eine Replikation unter Verwendung der unten aufgeführten Variablen durchführen.

Batch-Einfügung/Aktualisierung durchführen

Um eine Batch-Einfügung/Aktualisierung durchzuführen, setzen Sie die Variable jitterbit.plugin.DbUpdate.UseOracleSqlldr auf false oder null.

Das Plugin liest Daten aus der Zieldatei und fügt eine Datenbanktabelle ein oder aktualisiert sie. Es wird davon ausgegangen, dass die Zieldatei im CSV-Format mit UTF-8-Codierung vorliegt.

Das Plugin-Protokoll befindet sich unter <JITTERBIT_HOME>/log/plugin/. Beispiel für einen Protokolldateinamen: DbUpdate_Account_2013_03_11.log.

Führen Sie eine Replikation durch

Um eine Replikation durchzuführen:

  1. Setzen Sie die Variable jitterbit.plugin.DbUpdate.UseOracleSqlldr auf true.
  2. Setzen Sie die Variable jitterbit.plugin.DbUpdate.ControlFile, um die Dateinamen zu erstellen:
    • Der Steuerdateiname wird aus dem Variablenwert + .ctrl zusammengesetzt.
    • Der Datendateiname wird aus dem Variablenwert + .data zusammengesetzt.
    • Der SQLLDR-Protokolldateiname wird aus dem Variablenwert + .log zusammengesetzt.

Der Prozess kann eine Folge von Antworten von query/queryMore generieren.

Das Plugin wird am Ende der Antworttransformation auf der Zieldatei ausgeführt.

Beim ersten Ausführen des Plugins wird der Header (jitterbit.plugin.DbUpdate.ControlHeader) in die Steuerdatei kopiert und die Zieldatei in die Datendatei. Bei nachfolgenden Ausführungen wird die Zieldatei an die Datendatei angehängt.

Variablen

Name Typ Erforderlich Beschreibung
jitterbit.plugin.DbUpdate.ColumnName_list Zeichenkette Optional

Normalerweise werden alle Felder im Salesforce-Objekt in die Datenbanktabelle übertragen, und der Primärschlüssel der Tabelle ist "ID". Um einige Felder zu überspringen oder andere Primärschlüssel zu verwenden, können Sie diese optionale globale Variable verwenden.

In diesem Fall muss die Primärschlüsselspalte in der Liste das Label "(PR)" anhängen, sodass die Liste wie folgt aussieht:

Id(PR),Name, . . . |

jitterbit.plugin.DbUpdate.ControlHeader Zeichenkette Optional Der Header, der in die Steuerdatei kopiert werden soll.
jitterbit.plugin.DbUpdate.ControlFile Zeichenkette Optional

Für eine Replikation:

  • Der Steuerdateiname wird aus dem Variablenwert + .ctrl zusammengesetzt.
  • Der Datendateiname wird aus dem Variablenwert + .data zusammengesetzt.
  • Der SQLLDR-Protokolldateiname wird aus dem Variablenwert + .log zusammengesetzt.

jitterbit.plugin.DbUpdate.DbGuid Zeichenkette Optional Die Datenbank-GUID.
jitterbit.plugin.DbUpdate.DebugMode Zeichenkette Optional Setzen Sie auf einen beliebigen Wert, um den Debug-Modus zu aktivieren. Wenn der Debug-Modus aktiviert ist, wird das Protokollieren hinzugefügt.
jitterbit.plugin.DbUpdate.SqlLdrAuth Zeichenkette Optional Die Oracle SQL Loader-Authentifizierung.
jitterbit.plugin.DbUpdate.SqlLdrPath Zeichenkette Optional Der Pfad zum Oracle SQL Loader.
jitterbit.plugin.DbUpdate.TableName Zeichenkette Optional Diese Variable kann den Schemanamen enthalten. Zum Beispiel "OWNER:ACCOUNT".

Hinweis

Der Name der Primärschlüsselspalte der Datenbanktabelle muss "ID" sein.

jitterbit.plugin.DbUpdate.UseOracleSqlldr Boolean Optional

Für eine Replikation setzen Sie den Wert auf true.

Für ein Einfügen/Aktualisieren setzen Sie den Wert auf false oder null.

Der Standardwert ist false.