Zum Inhalt springen

Datenbank Insert-Aktivität

Einführung

Eine Datenbank Insert-Aktivität, die ihre Datenbankverbindung verwendet, fügt neue Daten in die konfigurierte Datenbank ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

Die Insert-Aktivität wird verwendet, um neue Datensätze in der konfigurierten Datenbank zu erstellen. Wenn stattdessen Datensätze eingefügt werden sollen, wenn sie noch nicht existieren, sowie Datensätze aktualisiert werden sollen, wenn sie existieren, verwenden Sie eine Datenbank Upsert-Aktivität.

Erstellen einer Datenbank Insert-Aktivität

Eine Instanz einer Datenbank Insert-Aktivität wird aus einer Datenbankverbindung unter Verwendung des Aktivitätstyps Insert erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Datenbank Insert-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Datenbank Insert-Aktivität

Befolgen Sie diese Schritte, um eine Datenbank Insert-Aktivität zu konfigurieren:

Einzelobjekt-Einfügen

Befolgen Sie diese Schritte, wenn der Datenbankeintrag für ein einzelnes Objekt erfolgt und keine Joins mit anderen Objekten erstellt werden müssen. Wenn Sie mehrere Objekte verknüpfen müssen, verweisen Sie stattdessen auf Multiple-object insert.

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

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

  • Geben Sie die Tabellenreferenzen an: Dieser Abschnitt zeigt die in der Datenbank-Endpunkt verfügbaren Tabellen unter Verwendung aller angewendeten Filter an, nachdem das Aktualisierungssymbol für das anfängliche Laden der Objekte verwendet wurde. Wenn eine große Anzahl von Objekten in der Datenbank vorhanden ist, wird empfohlen, die Objekte vor dem Aktualisieren mit Ansicht oder Suche zu filtern.

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

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die Liste der Objekte kann automatisch gefiltert werden, oder Sie müssen die Liste möglicherweise aktualisieren, abhängig davon, ob die Objekte bereits abgerufen wurden:

      • Wenn Sie nach Objekten suchen, die bereits aus der Datenbank abgerufen wurden und bereits in der Liste erscheinen, filtern alle Suchbegriffe, die im Suchfeld eingegeben werden, automatisch die Liste.

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

      Hinweis

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

    • Aktualisieren: Klicken Sie auf das Aktualisierungs-Icon, um Tabellen vom Datenbank-Endpunkt zu laden oder neu zu laden. Dies muss für das initiale Laden von Objekten verwendet werden. Darüber hinaus kann es 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.

    • Erlauben Sie das Truncieren von Zeichenfeldern, um Fehler bei der Feldlänge zu vermeiden: Wählen Sie dieses Kontrollkästchen aus, um das Truncieren von Feldern zuzulassen, falls das Ziel-Feld kleiner ist als das Quell-Feld. Es ist standardmäßig für neue Aktivitäten, die nach der Harmony 11.39-Version erstellt wurden, nicht ausgewählt. Wenn dieses Kontrollkästchen nicht ausgewählt ist und übergroße Daten durchgelassen werden, wird ein Fehler-Status gemeldet. Wenn das Kontrollkästchen ausgewählt ist, wird stattdessen ein Erfolg mit Informationen Status gemeldet, und die Betriebsprotokolle geben an, dass Einer oder mehrere Werte wurden beim Einfügen und/oder Aktualisieren des Feldes trunciert.

    • Schema/Eigentümer in den Tabellennamen einfügen: Wählen Sie dieses Kontrollkästchen aus, um das Schema in den Tabellennamen einzufügen. Dies kann nützlich sein, wenn Sie denselben Tabellennamen in mehreren Schemata (z. B. für Entwicklung und Produktion) verwenden, um die Tabelle im richtigen Schema sehen und auswählen zu können.

    • Referenz der Tabellennamen 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 in mehrere Objekte einfügen, die verbunden werden müssen, verweisen Sie auf Einfügen mehrerer Objekte.

      Tipp

      Wenn die Liste auch nach Anwendung eines Filters nicht mit verfügbaren Objekten gefüllt wird, könnte die Datenbankverbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen 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 für Einfügungen von Einzelobjekten nicht relevant und können nicht bearbeitet werden, außer um das Objekt zu entfernen (fahren Sie mit der Maus über die ganz rechte Spalte und klicken Sie auf das Entfernen-Symbol). Wenn Sie in mehrere Objekte einfügen, die verbunden werden müssen, beziehen Sie sich auf Einfügen von mehreren Objekten.

  • Speichern & Beenden: Wenn 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen des Datenschemas

  • Datenschema: Das Ziel-Datenschema wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformations-Mappings erneut angezeigt, wo Sie Ziel-Felder mit Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Hinweis

    Daten werden so übertragen, wie sie bereitgestellt werden. Wenn es Unterschiede in der Datenlänge zwischen Quell- und Ziel-Feldern gibt, können Sie String-Funktionen verwenden, um die Daten zu kürzen.

    Hinweis

    Um ein Datenschema in einer bestehenden Aktivität zu aktualisieren, müssen Sie durch jeden Schritt der Aktivitätskonfiguration erneut fortschreiten und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Namens der Aktivität hinzufügen oder 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: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

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

Mehrfachobjekt-Einfügung

Befolgen Sie diese Schritte, wenn die Datenbankeinfügung mehrere Objekte umfasst und Sie Verknüpfungen zwischen ihnen erstellen müssen. Um nur in ein einzelnes Objekt ohne Verknüpfungen einzufügen, verweisen Sie stattdessen auf Einzelobjekt-Einfügung.

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

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

  • Geben Sie die Tabellennamenreferenz an: In diesem Abschnitt werden die in dem Datenbank-Endpunkt verfügbaren Tabellen angezeigt, nachdem Sie das Aktualisierungssymbol für das erste Laden der Objekte verwendet haben. Wenn eine große Anzahl von Objekten in der Datenbank vorhanden ist, wird empfohlen, die Objekte vor dem Aktualisieren mit Ansicht oder Suche zu filtern.

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

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. 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 erscheinen, filtern automatisch alle eingegebenen Suchbegriffe die Liste.

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

      Hinweis

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

    • Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol, um Tabellen vom Datenbank-Endpunkt zu laden oder neu zu laden. Dies muss für das initiale Laden von Objekten verwendet werden. Darüber hinaus kann es 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.

    • Erlauben Sie das Truncieren von Zeichenfeldern, um Fehler bei der Feldlänge zu vermeiden: Wählen Sie dieses Kontrollkästchen aus, um zuzulassen, dass Felder nach Bedarf gekürzt werden, wenn das Ziel-Feld kleiner ist als das Quell-Feld. Es ist standardmäßig nicht ausgewählt. Wenn dieses Kontrollkästchen nicht ausgewählt bleibt und übergroße Daten durchgelassen werden, wird ein Fehler-Status angezeigt. Wenn das Kontrollkästchen ausgewählt ist, wird stattdessen ein Erfolg mit Informationen-Status angezeigt, und die Betriebsprotokolle geben an, dass Einer oder mehrere Werte wurden beim Einfügen und/oder Aktualisieren des Feldes gekürzt.

    • Schema/Eigentümer in den Tabellennamen einbeziehen: Wählen Sie dieses Kontrollkästchen aus, um das Schema in den Tabellennamen einzubeziehen. Dies kann nützlich sein, wenn Sie denselben Tabellennamen in mehreren Schemata (z. B. für Entwicklung und Produktion) verwenden, um die Tabelle im richtigen Schema sehen und auswählen zu können.

    • Referenz der Tabellennamen bereitstellen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie nacheinander auf die Objekte, um sie der Tabelle auf der rechten Seite hinzuzufügen. Es können beliebige Kombinationen von Tabellen, Ansichten und/oder Systemtabellen ausgewählt werden. Wenn Sie stattdessen in ein einzelnes Objekt ohne Joins einfügen müssen, beziehen Sie sich stattdessen auf Einzelobjekt-Einfügen.

      Tipp

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

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

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

        Hinweis

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

      • Elternteil: Bei jedem Kindobjekt, das verbunden wird, verwenden Sie das Dropdown-Menü, um den Namen des Objekts auszuwählen, das der Elternteil sein soll. Dies ist erforderlich, um die transaktionale Integrität eines Objekts durchzusetzen und um die Verknüpfungsschlüssel für ein Kindobjekt abzuleiten.

      • Verknüpfungstyp: Bei jedem Kindobjekt, das verbunden wird, wird ein Dropdown-Menü verfügbar, nachdem Sie Verknüpfungsschlüssel zugewiesen haben (im nächsten Abschnitt behandelt). Verwenden Sie das Dropdown-Menü, um den Typ der Beziehung zwischen den ausgewählten Objekten festzulegen:

        • Eins oder Mehr: Dieser Verknüpfungstyp erfordert, dass jeder Elterndatensatz mindestens 1 Kinddatensatz hat und möglicherweise mehr Kinddatensätze.

        • Nur Eins: Dieser Verknüpfungstyp erfordert, dass jeder Elterndatensatz 1 und nur 1 Kinddatensatz hat.

        • Null oder Mehr: Dieser Verknüpfungstyp erlaubt es jedem Elterndatensatz, entweder 0 oder mehr Kinddatensätze zu haben.

        • Null oder Eins: Dieser Verknüpfungstyp erlaubt es jedem Elterndatensatz, entweder 0 Kinddatensätze oder nur 1 Kinddatensatz zu haben.

      • Verknüpfungsschlüssel: Bei jedem Kindobjekt, das verbunden wird, erscheint, sobald ein Objekt als Elternteil ausgewählt wurde, ein roter Zuweisen-Link in diesem Feld. Klicken Sie auf Zuweisen, um ein separates Fenster zu öffnen, in dem Sie die Verknüpfungsschlüssel zuweisen.

        • Elternobjekt: Das Elternobjekt 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 Namen zu filtern.

        • Kindobjekt: Das Kindobjekt 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 Namen zu filtern.

        • Linkschlüssel zuweisen: Um ein Feld als Linkschlüssel zuzuweisen, ziehen Sie ein Feld aus dem übergeordneten Objekt auf der linken Seite in ein Feld innerhalb des untergeordneten Objekts auf der rechten Seite oder umgekehrt. Um mehrere Linkschlüssel zuzuweisen, wiederholen Sie diesen Vorgang nach Bedarf.

        • Linkschlüssel abwählen: Um Linkschlüssel abzuwählen, klicken Sie auf ein beliebiges Feld, das bereits verknüpft ist. Die verknüpften Felder werden abgewählt.

        • Von vorne beginnen: Um alle zugewiesenen Linkschlüssel zu löschen, klicken Sie auf Von vorne beginnen, das sich unter der Liste der übergeordneten Objekte auf der linken Seite befindet.

        • Fertigstellen: Klicken Sie auf Fertigstellen, um die zugewiesenen Linkschlüssel zu speichern und das Fenster zu schließen. Unter Linkschlüssel sollten Sie nun die Anzahl der zugewiesenen Linkschlüssel sehen, auf die Sie klicken können, um das Fenster zur Zuweisung von Linkschlüsseln erneut zu öffnen. Darüber hinaus wird das Dropdown-Menü Verknüpfungstyp verfügbar, damit Sie den Typ 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 mit der Maus über die ganz rechte Spalte und klicken Sie auf das Entfernen-Symbol.

  • Speichern & Beenden: Wenn 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen des Datenschemas

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

  • 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Datenbank-Einfügen-Aktivität konfiguriert haben, können Sie diese in einer Operation oder einem Skript wie unten beschrieben verwenden.

Operation abschließen

Nachdem Sie eine Datenbank-Einfügen-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

Datenbank-Einfügen-Aktivitäten können als Ziel mit diesen Betriebsmustern verwendet werden:

Andere Muster sind bei der Verwendung von Datenbank-Einfügen-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

Innerhalb einer Transformation, wenn die Option verwendet wird, um ein Schema zu spiegeln, das von einer Datenbankaktivität unter Verwendung 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 das Durchlaufen aller Datensätze zu ermöglichen (siehe Schleifenknoten unter Datenstrukturen).

Zusätzlich ist zu beachten, dass beim Verknüpfen von Datenbanktabellen die Werte der verknüpften Felder einer Kindtabelle standardmäßig den Werten der verknüpften Felder der Elterntabelle entsprechen. Die verknüpften Felder einer Kindtabelle können nicht zugeordnet werden.

Wenn Sie bereit sind, führen Sie die Bereitstellung und Ausführung der Operation durch und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.

Verwenden von Datenbankaktivitäten in Skripten

Datenbank Einfügen-Aktivitäten können auch in einem Skript referenziert werden, um mit Skriptfunktionen verwendet zu werden, die ein Datenbank-target als Parameter verwenden, einschließlich dieser:

  • DBLoad
  • DBWrite

Für weitere Details zur Referenzierung von Aktivitäten in Skripten siehe Endpoints in Jitterbit Script.

Darüber hinaus können Sie möglicherweise zusätzliche Datenbankfunktionen in der Transformation verwenden. Wenn Sie beispielsweise auf ein Datenbankziel abbilden und ein Mehrtabelle-Ziel mit Eltern-Kind-Beziehungen haben und Daten einfügen, können Sie die Transformationsfunktionen <SQLIDENTITY> und <SEQUENCE> verwenden.

  • <SQLIDENTITY> wird für alle nicht-Oracle-Zieldatenbanken verwendet, die Identitäts- oder automatische Nummerngenerierungsschlüssel unterstützen. Nachdem der Elternteil eingefügt wurde, kann das Kind die generierte Nummer vom Elternteil erben, indem diese Funktion dem Fremdschlüssel in der Kindtabelle zugeordnet wird.

  • <SEQUENCE> führt eine ähnliche Aktion mit Oracle-Datenbanken aus.

Chunking verwenden

Beim Einsatz von Chunking in einer Operation, bei der das Ziel eine Datenbankaktivität ist, ist zu beachten, 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 an die Datenbank zum Einfügen/Aktualisieren gesendet wird.

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

Für Anweisungen und bewährte Praktiken zur Verwendung von Chunking siehe Betriebsoptionen.