Zum Inhalt springen

Datenbankabfrage-Aktivität

Einführung

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

Erstellen einer Datenbankabfrage-Aktivität

Eine Instanz einer Datenbank Abfrage-Aktivität wird aus einer Datenbankverbindung unter Verwendung des Abfrage-Aktivitätstyps 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 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

  • 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 selbst nach Anwendung von Filtern zeitlich begrenzt ist, verwenden Sie eine manuelle SQL-Anweisung.

    • Ansicht: Verwenden Sie das Dropdown-Menü, um die angezeigte Objektliste 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, 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 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 einschränken 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.

    • 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 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 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 der Tabelle auf der rechten Seite hinzuzufügen. Wenn Sie mehrere Objekte abfragen, die verbunden werden müssen, beziehen Sie sich auf Abfrage mehrerer Objekte 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, beziehen Sie sich 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 die Schaltfläche Fertig im letzten Schritt klicken.

  • Assistent ü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 Assistentenabfrage.

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

Tipp

Felder mit einem Symbol für Variablen 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 Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

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

    • Suchen: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. 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 ausgeklappte 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 untenstehenden Felder 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:

      Arithmetik
      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
      Verbindung
      Operator Beschreibung
      += Addiert gleich
      -= Subtrahiert gleich
      *= Multipliziert gleich
      /= Dividiert 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 Elternaufzeichnungen 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 Beispielaufzeichnungen 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 Zielfelder 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 abläuft, 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 eingegebenen Suchbegriffe 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 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 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 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.

    • 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, beziehen Sie sich stattdessen 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.

      • Join Type: Nach der Zuweisung von Link Keys wählen Sie den Beziehungstyp für jedes untergeordnete Objekt aus:

        • One or More: Jeder übergeordnete Datensatz muss mindestens 1 untergeordneten Datensatz haben.

        • One Only: Jeder übergeordnete Datensatz muss genau 1 untergeordneten Datensatz haben.

        • Zero or More: Jeder übergeordnete Datensatz kann 0 oder mehr untergeordnete Datensätze haben.

        • Zero or One: Jeder übergeordnete Datensatz kann 0 oder 1 untergeordneten Datensatz haben.

      • Link Keys: Für jedes untergeordnete Objekt mit einem ausgewählten Parent klicken Sie auf den roten Assign-Link, um die Schlüsselbeziehungen einzurichten:

      • Link Keys: Bei jedem untergeordneten Objekt, das verbunden wird, erscheint, sobald ein Objekt als Parent ausgewählt ist, ein roter Assign-Link in diesem Feld. Klicken Sie auf Assign, um ein separates Fenster zu öffnen, in dem Sie die Link-Keys zuweisen.

        • Parent object: Zeigt das übergeordnete Objekt 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.

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

        • Assign link key(s): Ziehen Sie ein Feld vom übergeordneten zum untergeordneten Objekt (oder umgekehrt), um einen Link zu erstellen. Wiederholen Sie dies für mehrere Schlüssel.

        • Unassign link key(s): Um Link-Keys zu entfernen, klicken Sie auf ein Feld, das bereits verknüpft wurde. Die verknüpften Felder werden abgewählt.

        • Start over: Löscht alle zugewiesenen Link-Keys.

        • Finish: Speichert Ihre Link-Keys und zeigt die Anzahl in der Link Keys-Spalte an. Das Dropdown-Menü Join Type wird verfügbar.

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

      • Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

      • Next: 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 Parent-Objekte angegeben, den Join Type festgelegt und Link Keys zugewiesen haben. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Finished 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 verwerfen möchten.

Schritt 2: Bedingungen hinzufügen

Tipp

Felder mit einem Symbol für Variablen 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 Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

  • 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 (eingeklappte 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, damit sie automatisch zur SQL-Anweisung auf der rechten Seite hinzugefügt werden. 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: 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 gängigen 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 auf untergeordneten Feldern wirkt sich auch auf die übergeordneten Datensätze aus.

    • Sie können benutzerdefinierte Funktionen (UDF) innerhalb der SQL-Anweisung unter Verwendung der <UDF> Funktion verwenden. Diese Funktion ermöglicht es Ihnen, jede von der Ziel-Datenbank unterstützte Datenbankfunktion zu verwenden, wie die TO_DATE-Funktion in Oracle oder die 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 Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Ä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 Entwurfskanvas zugänglich. Für Details siehe 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 Vorgangsvalidität.

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, wenn Datenbanktabellen verbunden werden, beachten Sie, dass die Werte der verbundenen Felder einer Kindtabelle standardmäßig die Werte der verbundenen Felder der Elterntabelle übernehmen. Die verbundenen Felder einer Kindtabelle können nicht zugeordnet werden.

Wenn Sie bereit sind, deployen und ausführen Sie die Operation 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 für die Verwendung mit Skriptfunktionen referenziert 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 Script 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 Transformationsschritt chunked, nicht beim Abrufen der Daten. Die Zieldaten werden zunächst in zahlreiche temporäre Dateien (eine für jeden Chunk) geschrieben. Diese Dateien werden dann in einer Zieldatei kombiniert.

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