Zum Inhalt springen

Datenbankabfrage-Aktivität in Jitterbit Studio

Einführung

Eine Datenbank Abfrage-Aktivität, die ihre Datenbankverbindung verwendet, fragt Daten von einem Datenbank-Endpunkt ab und ist dazu gedacht, als Quelle verwendet zu werden, um Daten in einer Operation bereitzustellen.

Erstellen einer Datenbankabfrage-Aktivität

Eine Instanz einer Datenbank Abfrage-Aktivität wird aus einer Datenbankverbindung unter Verwendung des Aktivitätstyps Abfrage 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 weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

Konfigurieren einer Datenbankabfrage-Aktivität

Befolgen Sie die Schritte in einem dieser Abschnitte, um eine Datenbank Abfrage-Aktivität zu konfigurieren:

Einzelobjektabfrage mit Assistenten

Befolgen Sie diese Schritte, um den Assistenten zu verwenden, wenn Sie ein einzelnes Objekt abfragen und keine Verknüpfungen mit anderen Objekten erstellen müssen. Wenn Sie mehrere Objekte verknüpfen müssen, beziehen Sie sich stattdessen auf Abfrage mehrerer Objekte mit dem Assistenten, oder wenn Sie bereits die SQL-Anweisung kennen und einen JDBC-Treiber verwenden, siehe Manuelle Abfrage.

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

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps 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 Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration 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 Datenbank-Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabelle(n) auswählen: Dieser Abschnitt zeigt die in dem Datenbankendpunkt verfügbaren Tabellen unter Verwendung aller angewendeten Filter an, nachdem Sie das Aktualisierungssymbol für das erste Laden der Objekte verwendet haben. Wenn es viele Objekte in der Datenbank gibt, können Sie die Objekte vor dem Aktualisieren mit Ansicht oder Suche filtern. Wenn das Abrufen der Objekte selbst nach Anwendung von Filtern zeitlich abläuft, verwenden Sie eine manuelle SQL-Anweisung.

    • Ansicht: Verwenden Sie das Dropdown-Menü, um die Liste der angezeigten Objekte auf eines von "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 angezeigt werden, 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 mit dem Filter aus der Datenbank abzurufen.

      Hinweis

      Datenbanken wie Microsoft Access unterstützen keine Objektsuche und liefern keine Ergebnisse zurück.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol, 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 auch nützlich sein, wenn Sie kürzlich Objekte zur Datenbank hinzugefügt haben oder wenn Sie zusätzliche Suchkriterien haben, die Sie vor dem Abrufen der Datenbankobjekte anwenden möchten.

  • 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 verwenden (z. B. für Entwicklung und Produktion), um die Tabelle im richtigen Schema sehen und auswählen zu können.

  • Tabelle(n) auswählen: 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 abfragen, die verbunden werden müssen, verweisen Sie auf Mehrere-Objekte-Abfrage mit dem Assistenten.

    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 Abfragen mit einem einzelnen Objekt nicht relevant und diese Felder können nicht bearbeitet werden, außer um das Objekt zu entfernen (fahren Sie mit der Maus über die rechte Spalte und klicken Sie auf das Entfernen-Symbol). Wenn Sie mehrere Objekte abfragen, die verbunden werden müssen, verweisen Sie auf Abfrage mehrerer Objekte mit dem Assistenten.

  • 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.

  • Assistent überspringen / SQL-Anweisung schreiben: Wechseln Sie zu manuellem Schreiben einer benutzerdefinierten SQL-Anweisung.

    Hinweis

    Das Speichern einer benutzerdefinierten SQL-Anweisung überschreibt jede zuvor gespeicherte Assistentenabfrage.

  • Ä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: Bedingungen hinzufügen

Tipp

Felder mit einem Variablen-Symbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Symbol klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Felder auswählen: Dieser Abschnitt zeigt die Felder für das/die ausgewählte(n) Objekt(e), die im Datenbank-Endpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Die Suche ist nicht groß-/kleinschreibungssensitiv. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

    • Alle auswählen: Wenn Sie das Suchfeld verwenden, um zu filtern, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen (Objekte und ausgeblendete Felder werden nicht ausgewählt).

    • Felder auswählen: Wählen Sie die Kontrollkästchen der Felder aus, die Sie in die Abfrage einbeziehen möchten, damit sie automatisch zur SQL-Anweisung auf der rechten Seite hinzugefügt werden. Sofern Sie das Suchfeld nicht verwenden, können Sie auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen.

  • SQL-Anweisung: Die Abfrageanweisung wird automatisch mit dem Objekt und allen auf der linken Seite ausgewählten Feldern ausgefüllt.

  • WHERE-Klausel (Optional): Um eine WHERE-Klausel hinzuzufügen, können Sie die Felder unten als Eingabe verwenden, um die Klausel zu erstellen, oder Sie können die Klausel manuell im unteren Textfeld eingeben. Es gibt Beispiele für WHERE-Klauseln auf den How-to-Seiten, die beschreiben, wie man sich mit häufig verwendeten Datenbanken verbindet. Nachdem Sie eine WHERE-Klausel hinzugefügt haben, müssen Sie zuerst die Abfrage mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

    • Objekt: Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus dem ausgewählten Objekt auszuwählen.

    • Operator: Verwenden Sie das Dropdown-Menü, um den entsprechenden Operator auszuwählen:

      Arithmetisch
      Operator Beschreibung
      + Addieren
      - Subtrahieren
      * Multiplizieren
      / Dividieren
      % Modulo
      Bitweise
      Operator Beschreibung
      & Bitweises UND
      | Bitweises ODER
      ^ Bitweises XOR (Exklusives ODER)
      Vergleich
      Operator Beschreibung
      = Gleich
      > Größer als
      \< Kleiner als
      >= Größer als oder gleich
      \<= Kleiner als oder gleich
      != Ungleich
      Zusammengesetzt
      Operator Beschreibung
      += Addiere gleich
      -= Subtrahiere gleich
      *= Multipliziere gleich
      /= Teile gleich
      %= Modulo gleich
      &= Bitweises UND gleich
      |*= Bitweises ODER gleich
      ^-= Bitweises exklusives ODER gleich
      Logisch
      Operator Beschreibung
      ALL WAHR, wenn alle Werte der Unterabfrage die Bedingung erfüllen
      AND WAHR, wenn alle durch AND getrennten Bedingungen WAHR sind
      ANY WAHR, wenn einer der Werte der Unterabfrage die Bedingung erfüllt
      BETWEEN WAHR, wenn der Operand im Bereich der Vergleiche liegt
      EXISTS WAHR, wenn die Unterabfrage ein oder mehrere Datensätze zurückgibt
      IN WAHR, wenn der Operand gleich einem der Ausdrücke in der Liste ist
      LIKE WAHR, wenn der Operand einem Muster entspricht
      NOT Zeigt einen Datensatz an, wenn die Bedingung(en) NICHT WAHR ist/sind
      OR WAHR, wenn eine der durch OR getrennten Bedingungen WAHR ist
      SOME WAHR, wenn einer der Werte der Unterabfrage die Bedingung erfüllt

    • Wert: Geben Sie den Wert ein, der mit Ihrem ausgewählten Feld und Operator verwendet werden soll.

      Tipp

      Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, geben Sie einen Standardwert an, um das Testen des Skripts zu ermöglichen. Ohne Standardwerte kann das Testen fehlschlagen, da globale Variablen nur zur Laufzeit Werte erhalten.

    • Hinzufügen: Erstellt die Klausel aus Ihren Auswahlmöglichkeiten und fügt sie in das Textfeld unten ein.

    Vorsicht

    Beim manuellen Schreiben von WHERE-Klauseln verwenden Sie die genaue Syntax, die von Ihrer Datenbank erforderlich ist. Sie können hier auch eine ORDER BY-Klausel hinzufügen, die sowohl die Kind- als auch die Eltern-Datensätze beeinflusst.

    Tipp

    Um mehrere Bedingungen zur WHERE-Klausel hinzuzufügen, wiederholen Sie den Vorgang, indem Sie zusätzliche Auswahlmöglichkeiten hinzufügen. Beachten Sie, dass Sie möglicherweise einen logischen Operator wie AND oder OR hinzufügen müssen, um die zusätzlichen Bedingungen zu berücksichtigen.

  • Testabfrage: Validiert Ihre Abfrage. Wenn sie nicht gültig ist, werden Fehlermeldungen angezeigt. Wenn sie gültig ist, werden bis zu 20 Beispiel-Datensätze angezeigt.

Schritt 3: Überprüfen des Datenschemas

  • Datenschema: Das Quell-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 mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Hinweis

    Um ein Datenschema in einer bestehenden Aktivität zu aktualisieren, müssen Sie jeden Konfigurationsschritt der Aktivität erneut durchlaufen 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Abfrage mehrerer Objekte mit dem Assistenten

Befolgen Sie diese Schritte, um mehrere Objekte mit Joins abzufragen:

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 Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabelle(n) auswählen: Dieser Abschnitt zeigt die in dem Datenbank-Endpunkt verfügbaren Tabellen unter Verwendung aller angewendeten Filter an, nachdem das Aktualisierungssymbol für das erste Laden der Objekte verwendet wurde. Wenn es viele Objekte in der Datenbank gibt, können Sie die Objekte vor dem Aktualisieren mit Ansicht oder Suche filtern. Wenn das Abrufen der Objekte zeitlich begrenzt ist, selbst nach Anwendung von Filtern, verwenden Sie eine manuelle SQL-Anweisung.

    • 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 Suchbegriffe, die im Suchfeld eingegeben werden, die Liste.

      • Wenn Sie nach Objekten suchen, die noch nicht abgerufen wurden, beispielsweise 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 aus der Datenbank mit dem Filter abzurufen.

        Hinweis

        Datenbanken wie Microsoft Access unterstützen keine Objektsuche und liefern keine Ergebnisse.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol, 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.

    • Schema/Eigentümer in den Tabellennamen einbeziehen: Wählen Sie dieses Kontrollkästchen aus, um das Schema in den Tabellennamen einzuschließen. 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 zu sehen und auszuwählen.

    • Tabelle(n) auswählen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie nacheinander auf die Objekte, um sie zur Tabelle auf der rechten Seite hinzuzufügen. Es können beliebige Kombinationen von Tabellen, Ansichten und/oder Systemtabellen ausgewählt werden. Wenn Sie stattdessen ein einzelnes Objekt ohne Joins abfragen müssen, verweisen Sie auf Einzelobjektabfrage mit dem Assistenten.

      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.

        Tipp

        Tabellen mit Sonderzeichen wie + in ihren Namen erfordern eine manuelle Abfrage. Der Tabellenname muss in eckige Klammern ([ ]) eingeschlossen werden. Zum Beispiel: SELECT * FROM [table+].

      • Eltern: Für jedes Kindobjekt, das verbunden wird, wählen Sie das übergeordnete Objekt aus. Dies stellt die Beziehungshierarchie her und hilft, Verknüpfungsschlüssel abzuleiten.

      • Verknüpfungstyp: Nachdem Sie Verknüpfungsschlüssel zugewiesen haben, wählen Sie den Beziehungstyp für jedes untergeordnete Objekt aus:

        • Eins oder Mehrere: Jeder übergeordnete Datensatz muss mindestens 1 untergeordneten Datensatz haben.

        • Nur Eins: Jeder übergeordnete Datensatz muss genau 1 untergeordneten Datensatz haben.

        • Null oder Mehrere: Jeder übergeordnete Datensatz kann 0 oder mehr untergeordnete Datensätze haben.

        • Null oder Eins: Jeder übergeordnete Datensatz kann 0 oder 1 untergeordneten Datensatz haben.

      • Verknüpfungsschlüssel: Für jedes untergeordnete Objekt mit einem ausgewählten Elternteil klicken Sie auf den roten Zuweisen-Link, um Schlüsselbeziehungen einzurichten:

      • Verknüpfungsschlüssel: Bei jedem untergeordneten Objekt, das verbunden wird, erscheint, sobald ein Objekt als Elternteil ausgewählt ist, 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: Zeigt das Elternobjekt und seine Felder auf der linken Seite an. Primärschlüssel haben ein Schlüssel-Icon. Verwenden Sie das Suchfeld, um Felder bei Bedarf zu filtern.

        • Untergeordnetes Objekt: Zeigt das untergeordnete Objekt und seine Felder auf der rechten Seite an. Verwenden Sie das Suchfeld, um Felder bei Bedarf zu filtern.

        • Verknüpfungsschlüssel zuweisen: Ziehen Sie ein Feld vom Elternteil zum Kind (oder umgekehrt), um eine Verknüpfung zu erstellen. Wiederholen Sie dies für mehrere Schlüssel.

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

        • Von vorne beginnen: Löscht alle zugewiesenen Verknüpfungsschlüssel.

        • Fertigstellen: Speichert Ihre Verknüpfungsschlüssel und zeigt die Anzahl in der Spalte Verknüpfungsschlüssel an. Das Dropdown-Menü Verknüpfungstyp wird verfügbar.

      • Entfernen: Um ein ausgewähltes Objekt aus der Tabelle zu entfernen, fahren Sie mit der Maus über die rechte Spalte und klicken Sie auf das Entfernen-Icon.

      • 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. Diese Schaltfläche wird erst aktiviert, nachdem Sie alle Eltern-Objekte angegeben, den Verknüpfungstyp festgelegt und Verknüpfungsschlüssel zugewiesen haben. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

      • Wizard überspringen / SQL-Anweisung schreiben: Wechseln Sie zu manuell das Schreiben einer benutzerdefinierten SQL-Anweisung.

        Hinweis

        Das Speichern einer benutzerdefinierten SQL-Anweisung überschreibt jede zuvor gespeicherte Wizard-Abfrage.

      • Änderungen verwerfen: Klicken Sie nach Änderungen auf Schließen, 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: Bedingungen hinzufügen

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Quelle: Zeigt Felder für jedes ausgewählte Objekt an. Felder, die als Schlüssel identifiziert sind, müssen enthalten sein.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder für das ausgewählte Objekt zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

    • Alle auswählen: Wählen Sie das Kontrollkästchen aus, um alle sichtbaren Objekte und Felder auf einmal auszuwählen (eingeklappten Objekte werden nicht ausgewählt). Dieser Auswahlmodus ist nicht verfügbar, wenn objektspezifische Auswahlen verwendet werden, ist jedoch verfügbar, wenn das Suchfeld verwendet wird.

    • Felder auswählen: Wählen Sie die Kontrollkästchen der Felder aus, die Sie in die Abfrage einbeziehen möchten, um sie automatisch zur SQL-Anweisung auf der rechten Seite hinzuzufügen. Sie können auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen.

  • Tabelle der Objektfelder: Die ausgewählten Objekte und deren Felder werden in Tabellen auf der rechten Seite angezeigt, mit optionalen Feldern zum Hinzufügen von Bedingungen und Sortierungen:

    • Filterbedingung: Geben Sie optional eine Bedingung in Form des Arguments einer WHERE-Klausel ein; das heißt, Operator(en) gefolgt von Wert(en). Es gibt Beispiele für WHERE-Klauseln auf den How-to-Seiten, die beschreiben, wie man sich mit gängigen Datenbanken verbindet.

      Vorsicht

      Wenn Sie eine WHERE-Klausel manuell angeben, müssen Sie sie in der Syntax eingeben, die die Datenbank erfordert.

      Tipp

      Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, geben Sie einen Standardwert an, um das Testen des Skripts zu ermöglichen. Ohne Standardwerte kann das Testen fehlschlagen, da globale Variablen nur zur Laufzeit Werte erhalten.

    • Sortieren: Wählen Sie optional Keine, Aufsteigend oder Absteigend, um eine Sortierreihenfolge anzuwenden. Die Auswahl der Option Keine entspricht dem Leerlassen dieses Feldes.

      Vorsicht

      Die Verwendung von ORDER BY auf untergeordneten Feldern wirkt sich auch auf die übergeordneten Datensätze aus.

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

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 3: Überprüfen des Datenschemas

  • Datenschema: Das Quell-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 mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Hinweis

    Um ein Datenschema in einer bestehenden Aktivität zu aktualisieren, müssen Sie durch jeden Konfigurationsschritt der Aktivität 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.

Manuelle Abfrage

Befolgen Sie diese Schritte, wenn Sie die SQL-Anweisung kennen und eine JDBC-Treiberverbindung verwenden (nicht verfügbar für ODBC):

Schritt 1: Geben Sie einen Namen ein und überspringen Sie den Assistenten

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

  • Tabelle(n) auswählen: Überspringen Sie diesen Abschnitt, da er für manuelle Abfragen nicht relevant ist. Sie geben die Tabellen in Ihrer SQL-Anweisung an.

  • Weiter: Diese Schaltfläche sollte nicht aktiviert sein, da sie nur beim Verwenden des Datenbankabfrage-Assistenten anwendbar ist (siehe Einzelobjektabfrage mit Assistenten oder Mehrfachobjektabfrage mit Assistenten).

  • Assistent überspringen / SQL-Anweisung schreiben: Klicken Sie, um zum Schritt der SQL-Eingabe fortzufahren.

  • Ä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.

Schritt 2: Geben Sie eine SQL-Anweisung ein

  • SQL-Anweisung schreiben oder einfügen: Geben Sie die SQL-Abfrageanweisung ein. Hinweis:

    • Verwenden Sie die ANSI-SQL-konforme Syntax für den JDBC-Treiber Ihrer spezifischen Datenbank.

    • Es gibt eine Begrenzung von 2.000 Zeichen für SQL-Anweisungen.

      Hinweis

      Eine Umgehung für SQL-Anweisungen, die die Zeichenbeschränkung überschreiten, besteht darin, Datenbankansichten zu erstellen.

    • Um Variablen zu verwenden, geben Sie diese mit der in der Dokumentation für globale Variablen, Projektvariablen oder Jitterbit-Variablen beschriebenen Syntax in eckigen Klammern ein.

    • Bei der Verwendung von globalen Variablen in einer WHERE-Klausel sollte ein Standardwert angegeben werden, um das Testen des Skripts zu ermöglichen. Ohne Standardwerte kann das Testen fehlschlagen, da globale Variablen nur zur Laufzeit Werte erhalten. Es gibt Beispiele für WHERE-Klauseln auf den How-to-Seiten, die beschreiben, wie man sich mit häufig verwendeten Datenbanken verbindet.

    • Bei der Einrichtung einer SQL-Anweisung in einem Skript vor dieser Aktivität können Variablen mit anderen Zeichenfolgen verkettet werden, um gültiges SQL zu erstellen. Zum Beispiel: "SELECT * FROM " + $databaseName + ".Table". Die resultierende Zeichenfolge kann dann in einer anderen Variablen gespeichert und direkt in dieses Feld angewendet werden, indem die obigen Informationen verwendet werden.

    • Die Verwendung von ORDER BY-Klauseln für untergeordnete Felder wirkt sich auch auf die übergeordneten Datensätze aus.

    • Benutzerdefinierte Funktionen (UDF) können innerhalb der SQL-Anweisung unter Verwendung der <UDF> Funktion verwendet werden. Diese Funktion ermöglicht die Verwendung jeder von der Ziel-Datenbank unterstützten Datenbankfunktion, wie der TO_DATE Funktion in Oracle oder der CONVERT() Funktion in SQL Server. Weitere Einzelheiten finden Sie unter Datenbankfunktionen.

    • Um Sonderzeichen wie + in Tabellennamen zu verwenden, muss der Tabellenname in eckige Klammern ([ ]) eingeschlossen werden. Zum Beispiel: SELECT * FROM [Table+].

  • Testabfrage: Validiert Ihre Abfrage. Wenn sie nicht gültig ist, werden Fehlermeldungen angezeigt. Wenn sie gültig ist, werden bis zu 20 Beispiel-Datensätze angezeigt.

Schritt 3: Überprüfen des Datenschemas

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

    Hinweis

    Um ein Datenschema in einer bestehenden Aktivität zu aktualisieren, müssen Sie jeden Konfigurationsschritt der Aktivität erneut durchlaufen 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 Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Datenbank-Abfrage-Aktivität konfiguriert haben, können Sie diese innerhalb eines Vorgangs oder Skripts wie unten beschrieben verwenden.

Vorgang abschließen

Nachdem Sie eine Datenbank-Abfrage-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge 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-Abfrage-Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

Andere Muster sind bei der Verwendung von Datenbank-Abfrage-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Vorgangsgültigkeit.

Innerhalb einer Transformation, wenn die Option zum Spiegeln eines Schemas verwendet wird, die 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 alle Datensätze durchlaufen zu können (siehe Schleifenknoten unter Datenstrukturen).

Darüber hinaus 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, setzen Sie die Operation ein und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.

Datenbankaktivitäten in Skripten verwenden

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

Jitterbit-Skriptfunktionen

  • CacheLookup
  • CallStoredProcedure
  • DBCloseConnection
  • DBExecute
  • DBLookup
  • DBLookupAll
  • DBRollbackTransaction

JavaScript Jitterbit-Funktionen

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

Für weitere Details zur Referenzierung von Endpunkten in Skripten siehe Endpunkte in Jitterbit-Skript oder Endpunkte in JavaScript.

Chunking verwenden

Beim Einsatz von Chunking in einer Operation, bei der die Quelle eine Datenbankaktivität ist, wird die Datenverarbeitung im Transformationsprozess chunkiert, nicht beim Abrufen der Daten. Die Ziel-Daten werden zunächst in zahlreiche temporäre Dateien (eine für jeden Chunk) geschrieben. Diese Dateien werden dann in einer Zieldatei zusammengeführt.

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