Zum Inhalt springen

Database Upsert-Aktivität in Jitterbit Studio

Einführung

Eine Database Upsert-Aktivität verwendet ihre Datenbankverbindung und aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in einer konfigurierten Datenbank ein. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Die Upsert-Aktivität wird verwendet, um Datensätze zu aktualisieren, die bereits vorhanden sind, und um neue zu erstellen, die nicht vorhanden sind. Wenn Sie stattdessen nur neue Datensätze einfügen möchten, verwenden Sie eine Database Insert-Aktivität, oder wenn Sie vorhandene Datensätze aktualisieren möchten, verwenden Sie eine Database Update-Aktivität.

Erstellen einer Database Upsert-Aktivität

Eine Instanz einer Database Upsert-Aktivität wird aus einer Datenbankverbindung mit ihrem Upsert-Aktivitätstyp erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Database Upsert-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Database Upsert-Aktivität

Führen Sie diese Schritte aus, um eine Database Upsert-Aktivität zu konfigurieren:

Upsert mit einzelnem Objekt

Führen Sie diese Schritte aus, wenn das Datenbank-Upsert auf ein einzelnes Objekt erfolgt und Sie keine Verknüpfungen mit anderen Objekten erstellen müssen. Wenn Sie mehrere Objekte verknüpfen müssen, siehe stattdessen Upsert mit mehreren Objekten.

Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Datenbankaktivität zu identifizieren. Der Name muss für jede Database Upsert-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabellennamensreferenz bereitstellen: Dieser Abschnitt zeigt die in dem Datenbankendpunkt verfügbaren Tabellen mit angewendeten Filtern an, nachdem Sie das Symbol Aktualisieren zur ersten Ladung von Objekten verwendet haben. Wenn sich eine große Anzahl von Objekten in der Datenbank befindet, wird empfohlen, die Objekte vor dem Aktualisieren mit Ansicht oder Suche zu filtern.

  • Ansicht: Verwenden Sie das Dropdown-Menü, um die Liste der angezeigten Objekte auf "Tabellen, Ansichten", "Tabellen", "Ansichten" oder "Systemtabellen" zu filtern. Standardmäßig wird die Ansicht "Tabellen, Ansichten" angezeigt.

  • Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Die Liste der Objekte kann automatisch gefiltert werden oder Sie müssen die Liste möglicherweise aktualisieren, je nachdem, ob die Objekte bereits aus der Datenbank abgerufen wurden:

    • Wenn Sie nach Objekten suchen, die bereits aus der Datenbank abgerufen wurden und bereits in der Liste angezeigt werden, filtert jeder in das Suchfeld eingegebene Suchbegriff die Liste automatisch.

    • Wenn Sie nach Objekten suchen, die noch nicht abgerufen wurden, z. B. wenn Sie versuchen, die Anzahl der abgerufenen Objekte für Datenbanken mit einer großen Anzahl von Objekten zu begrenzen, verwenden Sie das Aktualisierungssymbol neben dem Suchfeld, um die Objekte mit dem Filter aus der Datenbank abzurufen.

    Hinweis

    Für Datenbanken, die keine Suche nach Objekten unterstützen, z. B. Microsoft Access, werden keine Ergebnisse zurückgegeben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol, um Tabellen vom Datenbankendpunkt zu laden oder neu zu laden. Dies muss für das erste Laden von Objekten verwendet werden. Darüber hinaus kann es auch hilfreich sein, wenn Sie kürzlich Objekte zur Datenbank hinzugefügt haben oder wenn Sie zusätzliche Suchkriterien anwenden möchten, bevor Sie Datenbankobjekte abrufen.

  • Abschneiden von Zeichenfeldern zulassen, um Feldlängenfehler zu vermeiden: Aktivieren Sie dieses Kontrollkästchen, um Felder bei Bedarf abzuschneiden, wenn das Zielfeld kleiner als das Quellfeld ist. Es ist standardmäßig deaktiviert für neue Aktivitäten, die nach dem Harmony 11.39 Release erstellt wurden. Wenn dieses Kontrollkästchen deaktiviert bleibt und zu große Daten durchlaufen, wird ein Fehler-Operationsstatus gemeldet. Wenn das Kontrollkästchen aktiviert ist, wird stattdessen ein Erfolg mit Info-Status gemeldet, und die Operationsprotokolle zeigen an, dass One or more values were truncated when inserting and/or updating the field.

  • Schema/Besitzer in die Tabellennamen einbeziehen: Aktivieren Sie dieses Kontrollkästchen, um das Schema in die Tabellennamen einzubeziehen. Dies kann hilfreich sein, wenn Sie denselben Tabellennamen in mehreren Schemas verwenden (z. B. für Entwicklung und Produktion), um die Tabelle im richtigen Schema anzuzeigen und auszuwählen.

  • Tabellennamen-Referenz bereitstellen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie auf ein einzelnes Objekt, um es zur Tabelle auf der rechten Seite hinzuzufügen. Wenn Sie mehrere Objekte aktualisieren oder zusammenführen, die verknüpft werden müssen, lesen Sie Mehrere Objekte zusammenführen.

    Tipp

    Wenn die Liste auch nach Anwendung eines Filters nicht mit verfügbaren Objekten gefüllt wird, ist die Datenbankverbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Tabelle der ausgewählten Objekte: Das ausgewählte Objekt wird in einer Tabelle auf der rechten Seite angezeigt. Die Spalten in dieser Tabelle sind nicht relevant für Zusammenführungen einzelner Objekte und können nicht bearbeitet werden.

  • Speichern und beenden: Klicken Sie auf diese Schaltfläche, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Zusammenführungsschlüssel auswählen

  • Schlüssel auswählen: Aktivieren Sie die Kontrollkästchen aller Felder, die Sie als Zusammenführungsschlüssel verwenden möchten. Sie können auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen. Zusammenführungsschlüssel sind die Felder, die verwendet werden, um zu identifizieren, welche vorhandenen Datensätze zusammengeführt werden müssen. Alle Felder, die als Zusammenführungsschlüssel ausgewählt wurden, werden auf der rechten Seite aufgelistet.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschema überprüfen

  • Datenschema: Das Zieldatenschema wird angezeigt. Wenn der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Hinweis

    Daten werden so übertragen, wie sie bereitgestellt werden. Wenn es Längenabweichungen zwischen Quell- und Zielfeldern gibt, können Sie Zeichenfolgenfunktionen verwenden, um die Daten zu kürzen.

    Hinweis

    Um ein Datenschema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie jeden Aktivitätskonfigurationsschritt erneut durchlaufen und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen und entfernen), um eine Schemaaktualisierung zu erzwingen.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Upsert mit mehreren Objekten

Führen Sie diese Schritte aus, wenn das Datenbank-Upsert oder Upsert für mehrere Objekte bestimmt ist und Sie Verknüpfungen zwischen ihnen erstellen müssen. Um nur ein einzelnes Objekt ohne Verknüpfungen zu aktualisieren oder einzufügen, lesen Sie Upsert mit einzelnem Objekt.

Schritt 1: Namen eingeben und Objekte auswählen

  • Name: Geben Sie einen Namen ein, um die Datenbankaktivität zu identifizieren. Der Name muss für jede Datenbankaktivität Upsert eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabellennamenreferenz bereitstellen: In diesem Abschnitt werden die im Datenbankendpunkt verfügbaren Tabellen angezeigt, nachdem Sie das Aktualisierungssymbol zum ersten Laden von Objekten verwendet haben. Wenn die Datenbank eine große Anzahl von Objekten enthält, wird empfohlen, die Objekte vor dem Aktualisieren mithilfe von Ansicht oder Suche zu filtern.

    • Ansicht: Verwenden Sie das Dropdown-Menü, um die Liste der angezeigten Objekte auf eine der Optionen „Tabellen, Ansichten", „Tabellen", „Ansichten" oder „Systemtabellen" zu filtern. Standardmäßig wird die Ansicht „Tabellen, Ansichten" angezeigt.

    • Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die Liste der Objekte kann automatisch gefiltert werden, oder Sie müssen die Liste möglicherweise aktualisieren, je nachdem, ob die Objekte bereits abgerufen wurden:

      • Wenn Sie nach Objekten suchen, die bereits aus der Datenbank abgerufen wurden und bereits in der Liste angezeigt werden, filtert jeder in das Suchfeld eingegebene Suchbegriff die Liste automatisch.

      • Wenn Sie nach Objekten suchen, die noch nicht abgerufen wurden, z. B. wenn Sie versuchen, die Anzahl der abgerufenen Objekte für Datenbanken mit einer großen Anzahl von Objekten zu begrenzen, verwenden Sie das Aktualisierungssymbol neben dem Suchfeld, um die Objekte mithilfe des Filters aus der Datenbank abzurufen.

Hinweis

Für Datenbanken, die keine Suche nach Objekten unterstützen, wie z. B. Microsoft Access, werden keine Ergebnisse zurückgegeben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Tabellen vom Datenbankendpunkt zu laden oder neu zu laden. Dies muss für das initiale Laden von Objekten verwendet werden. Darüber hinaus kann es auch nützlich sein, wenn Sie kürzlich Objekte zur Datenbank hinzugefügt haben oder wenn Sie zusätzliche Suchkriterien anwenden möchten, bevor Sie Datenbankobjekte abrufen.

  • Abschneiden von Zeichenfeldern zulassen, um Feldlängenfehler zu vermeiden: Aktivieren Sie dieses Kontrollkästchen, um Felder bei Bedarf abzuschneiden, wenn das Zielfeld kleiner als das Quellfeld ist. Standardmäßig ist diese Option deaktiviert. Wenn dieses Kontrollkästchen deaktiviert bleibt und übergroße Daten durchlaufen, wird ein Fehler-Status angezeigt. Wenn das Kontrollkästchen aktiviert ist, wird stattdessen ein Erfolg mit Info-Status angezeigt, und die Operationsprotokolle zeigen an, dass One or more values were truncated when inserting and/or updating the field.

  • Schema/Besitzer in Tabellennamen einschließen: Aktivieren Sie dieses Kontrollkästchen, um das Schema in die Tabellennamen einzubeziehen. Dies kann nützlich sein, wenn Sie denselben Tabellennamen in mehreren Schemas verwenden (z. B. für Entwicklung und Produktion), um die Tabelle im richtigen Schema anzuzeigen und auszuwählen.

  • Tabellennamensreferenz bereitstellen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie nacheinander auf Objekte, um sie zur Tabelle auf der rechten Seite hinzuzufügen. Es kann eine beliebige Kombination von Tabellen, Ansichten und/oder Systemtabellen ausgewählt werden. Wenn Sie stattdessen ein einzelnes Objekt ohne Verknüpfungen hochfahren müssen, lesen Sie stattdessen Single-object Upsert.

    Tipp

    Wenn die Liste auch nach Anwendung eines Filters nicht mit verfügbaren Objekten gefüllt wird, ist die Datenbankverbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Tabelle ausgewählter Objekte: Die ausgewählten Objekte werden in einer Tabelle auf der rechten Seite angezeigt. Jede Spalte wird nachfolgend beschrieben:

    • Tabelle: Der Name des ausgewählten Objekts, einer Tabelle, Ansicht oder Systemtabelle.

      Hinweis

      Tabellennamen mit Sonderzeichen wie + werden mit dieser Aktivität nicht unterstützt.

    • Übergeordnet: Verwenden Sie für jedes untergeordnete Objekt, das verknüpft wird, das Dropdown-Menü, um den Namen des Objekts auszuwählen, das das übergeordnete Objekt sein soll. Dies ist erforderlich, um die transaktionale Integrität eines Objekts zu gewährleisten und die Verknüpfungsschlüssel für ein untergeordnetes Objekt abzuleiten.

    • Verknüpfungstyp: Für jedes untergeordnete Objekt, das verknüpft wird, wird ein Dropdown-Menü verfügbar, nachdem Sie Verknüpfungsschlüssel zugewiesen haben (siehe nächster Punkt). Verwenden Sie das Dropdown-Menü, um den Beziehungstyp zwischen den ausgewählten Objekten festzulegen:

      • Ein oder mehr: Dieser Verknüpfungstyp erfordert, dass jeder übergeordnete Datensatz mindestens 1 untergeordneten Datensatz und möglicherweise mehr untergeordnete Datensätze hat.

      • Nur einer: Dieser Verknüpfungstyp erfordert, dass jeder übergeordnete Datensatz genau 1 untergeordneten Datensatz hat.

      • Null oder mehr: Dieser Verknüpfungstyp ermöglicht es jedem übergeordneten Datensatz, entweder 0 oder mehr untergeordnete Datensätze zu haben.

      • Null oder einer: Dieser Verknüpfungstyp ermöglicht es jedem übergeordneten Datensatz, entweder 0 untergeordnete Datensätze oder nur 1 untergeordneten Datensatz zu haben.

    • Verknüpfungsschlüssel: Für jedes untergeordnete Objekt, das verknüpft wird, wird ein roter Zuweisen-Link in diesem Feld angezeigt, sobald ein Objekt als Übergeordnet ausgewählt ist. Klicken Sie auf Zuweisen, um ein separates Fenster zu öffnen, in dem Sie die Verknüpfungsschlüssel zuweisen.

      • Übergeordnetes Objekt: Das übergeordnete Objekt und die Liste der Felder werden in der linken Spalte angezeigt. Alle Felder, die als Primärschlüssel in der Datenbank verwendet werden, sind durch ein Schlüsselsymbol gekennzeichnet. Wenn Sie eine große Anzahl von Feldern haben, können Sie das Suchfeld verwenden, um Felder nach Name zu filtern.

      • Untergeordnetes Objekt: Das untergeordnete Objekt und die Liste der Felder werden in der rechten Spalte angezeigt. Wenn Sie eine große Anzahl von Feldern haben, können Sie das Suchfeld verwenden, um Felder nach Name zu filtern.

  • Verknüpfungsschlüssel zuweisen: Um ein Feld als Verknüpfungsschlüssel zuzuweisen, ziehen Sie ein Feld vom übergeordneten Objekt auf der linken Seite zu einem Feld im untergeordneten Objekt auf der rechten Seite oder umgekehrt. Um mehrere Verknüpfungsschlüssel zuzuweisen, wiederholen Sie diesen Vorgang.

        -   **Verknüpfungsschlüssel entfernen:** Um Verknüpfungsschlüssel zu entfernen, klicken Sie auf ein Feld, das bereits verknüpft wurde. Die verknüpften Felder werden deselektiert.

    -   **Neu starten:** Um alle zugewiesenen Verknüpfungsschlüssel zu löschen, klicken Sie auf **Neu starten** unter der übergeordneten Liste auf der linken Seite.

    -   **Fertig stellen:** Klicken Sie auf **Fertig stellen**, um die zugewiesenen Verknüpfungsschlüssel zu speichern und das Fenster zu schließen. Unter **Verknüpfungsschlüssel** sollten Sie nun die Anzahl der zugewiesenen Verknüpfungsschlüssel sehen, auf die Sie klicken können, um das Fenster zur Zuweisung von Verknüpfungsschlüsseln erneut zu öffnen. Darüber hinaus wird das Dropdown-Menü **Verknüpfungstyp** verfügbar, damit Sie die Art der Beziehung (Kardinalität) zwischen den ausgewählten Objekten festlegen können.

-   **Entfernen:** Um ein ausgewähltes Objekt aus der Tabelle zu entfernen, fahren Sie über die Spalte ganz rechts und klicken Sie auf das Symbol „Entfernen" <span class="icon-trash" style="color: #908c94"></span>.

  • Speichern und beenden: Falls aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig stellen im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Upsert-Schlüssel auswählen

  • Schlüssel auswählen: Aktivieren Sie die Kontrollkästchen aller Felder, die Sie als Upsert-Schlüssel verwenden möchten. Sie können auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen. Upsert-Schlüssel sind die Felder, die verwendet werden, um zu identifizieren, welche vorhandenen Datensätze aktualisiert oder eingefügt werden müssen. Alle Felder, die als Upsert-Schlüssel ausgewählt wurden, werden auf der rechten Seite aufgelistet.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig stellen im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschema überprüfen

  • Datenschema: Das Zieldatenschema wird angezeigt. Falls der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Hinweis

    Um ein Datenschema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie alle Konfigurationsschritte der Aktivität erneut durchlaufen und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen und entfernen), um eine Aktualisierung des Schemas zu erzwingen.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig stellen: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Upsert-Aktivität für Datenbanken können Sie diese wie nachfolgend beschrieben in einem Vorgang oder Skript verwenden.

Vorgang abschließen

Nach der Konfiguration einer Upsert-Aktivität für Datenbanken schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgansschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

Database Upsert-Aktivitäten können als Ziel mit diesen Operationsmustern verwendet werden:

Andere Muster sind mit Database Upsert-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Operation validity.

Wenn man innerhalb einer Transformation die Option zum Spiegeln eines Schemas verwendet, das von einer Database-Aktivität mit einer einzelnen Tabelle (ohne Joins) bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Knoten namens row erstellt. Wenn Felder innerhalb dieses zusätzlichen Knotens zugeordnet werden, wird der Knoten zu einem Schleifenknoten, um alle Datensätze durchzuschleifen (siehe Schleifenknoten unter Datenstrukturen).

Darüber hinaus ist zu beachten, dass bei der Verknüpfung von Datenbanktabellen die Werte der verknüpften Felder einer untergeordneten Tabelle standardmäßig den Werten der verknüpften Felder der übergeordneten Tabelle entsprechen. Die verknüpften Felder einer untergeordneten Tabelle können nicht zugeordnet werden.

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten durch Überprüfung der Operationsprotokolle.

Database-Aktivitäten in Skripten verwenden

Database Upsert-Aktivitäten können auch in einem Skript referenziert werden, um sie mit Skriptfunktionen zu verwenden, die eine Datenbank target als Parameter verwenden, einschließlich dieser:

  • DBLoad
  • DBWrite

Weitere Informationen zum Referenzieren von Aktivitäten in Skripten finden Sie unter Endpoints in Jitterbit Script.

Darüber hinaus können Sie möglicherweise zusätzliche Datenbankfunktionen in der Transformation verwenden. Wenn Sie beispielsweise einem Datenbank-Ziel zuordnen und ein Multi-Table-Ziel mit Eltern-Kind-Beziehungen haben und Daten aktualisieren oder upserten, können Sie die Transformationsfunktionen <SQLIDENTITY> und <SEQUENCE> verwenden.

  • <SQLIDENTITY> wird für alle Nicht-Oracle-Zieldatenbanken verwendet, die Identitäts- oder automatisch generierende Nummernschlüssel unterstützen. Nach dem Einfügen des übergeordneten Elements kann das untergeordnete Element die generierte Nummer vom übergeordneten Element erben, indem diese Funktion dem Fremdschlüssel in der untergeordneten Tabelle zugeordnet wird.
  • <SEQUENCE> führt eine ähnliche Aktion mit Oracle-Datenbanken durch.

Chunking verwenden

Wenn Sie Chunking bei einer Operation verwenden, bei der das Ziel eine Database-Aktivität ist, beachten Sie, dass die Zieldaten zunächst in zahlreiche temporäre Dateien (eine für jeden Chunk) geschrieben werden. Diese Dateien werden dann zu einer Zieldatei kombiniert, die zur Einfügung/zum Upsert an die Datenbank gesendet wird.

Wenn Sie die Jitterbit-Variable jitterbit.target.db.commit_chunks auf 1 oder true setzen, wenn Chunking aktiviert ist, wird stattdessen jeder Chunk in die Datenbank committed, sobald er verfügbar ist. Dies kann die Leistung erheblich verbessern, da die Datenbank-Einfügungen/Upserts parallel ausgeführt werden.

Anweisungen und Best Practices zur Verwendung von Chunking finden Sie unter Operation options.