Zum Inhalt springen

Database Query-Aktivität in Jitterbit Studio

Einführung

Eine Database Query-Aktivität verwendet ihre Datenbankverbindung zum Abfragen von Daten aus einem Datenbankendpunkt und dient als Quelle zur Bereitstellung von Daten in einem Vorgang.

Database Query-Aktivität erstellen

Eine Instanz einer Database Query-Aktivität wird aus einer Datenbankverbindung mit dem Aktivitätstyp Query erstellt.

Um eine Aktivitätsinstanz 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 Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

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

Database Query-Aktivität konfigurieren

Führen Sie die Schritte in einem dieser Abschnitte aus, um eine Database Query-Aktivität zu konfigurieren:

Abfrage mit einzelnem Objekt mit Assistent

Führen Sie diese Schritte aus, 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, lesen Sie stattdessen Abfrage mit mehreren Objekten mit Assistent, oder wenn Sie die SQL-Anweisung bereits kennen und einen JDBC-Treiber verwenden, lesen Sie Manuelle Abfrage.

Schritt 1: Namen eingeben und Objekt auswählen

  • Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. 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 Query-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabelle(n) auswählen: Dieser Abschnitt zeigt die im Datenbankendpunkt verfügbaren Tabellen mit angewendeten Filtern an, nachdem das Symbol zum Aktualisieren für das erste Laden von Objekten verwendet wurde. Wenn sich viele Objekte in der Datenbank befinden, können Sie die Objekte vor dem Aktualisieren mit Ansicht oder Suche filtern. Wenn das Abrufen der Objekte auch nach dem Anwenden von Filtern eine Zeitüberschreitung aufweist, verwenden Sie eine manuelle SQL-Anweisung.

  • 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 Wert einer Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. 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

      Datenbanken wie Microsoft Access unterstützen die Objektsuche nicht und geben keine Ergebnisse zurück.

  • 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 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/Besitzer in die Tabellennamen einbeziehen: 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.

  • 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 verknüpft werden müssen, lesen Sie Mehrere-Objekt-Abfrage mit Assistent.

    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 für Abfragen mit einzelnen Objekten nicht relevant, und diese Felder können nicht bearbeitet werden, außer um das Objekt zu entfernen (bewegen Sie den Mauszeiger über die Spalte ganz rechts und klicken Sie auf das Entfernungssymbol). Wenn Sie mehrere Objekte abfragen, die verknüpft werden müssen, lesen Sie Mehrere-Objekt-Abfrage mit Assistent.

  • Speichern und beenden: Klicken Sie, falls aktiviert, 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.

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

    Hinweis

    Das Speichern einer benutzerdefinierten SQL-Anweisung überschreibt alle zuvor gespeicherten Assistentenabfragen.

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

Schritt 2: Bedingungen hinzufügen

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Felder auswählen: In diesem Bereich werden Felder für die ausgewählten Objekte angezeigt, die im Datenbankendpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

    • Suche: Geben Sie einen beliebigen Spaltenwert in das Suchfeld ein, um die Feldliste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

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

    • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, damit diese automatisch zur SQL-Anweisung auf der rechten Seite hinzugefügt werden. Sofern Sie nicht das Suchfeld 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 gefüllt.

  • WHERE-Klausel (Optional): Um eine WHERE-Klausel hinzuzufügen, können Sie die folgenden Felder als Eingabe verwenden, um die Klausel zu konstruieren, oder Sie können die Klausel manuell in das untere Textfeld eingeben. Es gibt Beispiele für WHERE-Klauseln auf den Seiten mit Anleitungen, die beschreiben, wie man sich mit häufig verwendeten Datenbanken verbindet. Nach dem Hinzufügen einer WHERE-Klausel müssen Sie die Abfrage zunächst 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/die entsprechenden Operator(en) auszuwählen:

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

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

    Tipp

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

  • Hinzufügen: Erstellt die Klausel aus den Auswahlen und fügt sie in das Textfeld unten ein.

Vorsicht

Verwenden Sie beim manuellen Schreiben von WHERE-Klauseln die genaue Syntax, die die Datenbank erfordert. Sie können hier auch eine ORDER BY-Klausel hinzufügen, die sich auf untergeordnete und übergeordnete Datensätze auswirkt.

Tipp

Um mehrere Bedingungen zur WHERE-Klausel hinzuzufügen, wiederholen Sie den Vorgang, indem Sie weitere Auswahlen 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.

  • Abfrage testen: Validiert die Abfrage. Falls ungültig, werden Fehlermeldungen angezeigt. Falls gültig, werden bis zu 20 Beispieldatensätze angezeigt.

Schritt 3: Überprüfen Sie das Datenschema

  • Datenschema: Das Quelldatenschema 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

    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 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Mehrere Objekte abfragen mit Assistent

Führen Sie diese Schritte aus, 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 Datenbankaktivität vom Typ Abfrage eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tabelle(n) auswählen: In diesem Bereich werden die im Datenbankendpunkt verfügbaren Tabellen angezeigt, nachdem Sie das Symbol zum Aktualisieren verwendet haben, um Objekte initial zu laden. Bei vielen Objekten in der Datenbank können Sie die Objekte vor dem Aktualisieren mit Ansicht oder Suche filtern. Falls das Abrufen der Objekte auch nach dem Anwenden von Filtern zu lange dauert, verwenden Sie eine manuelle SQL-Anweisung.

    • 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 aktualisieren. Dies hängt davon ab, 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 im 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 vielen Objekten zu begrenzen, verwenden Sie das Aktualisierungssymbol neben dem Suchfeld, um die Objekte mit dem Filter aus der Datenbank abzurufen.

        Hinweis

        Datenbanken wie Microsoft Access unterstützen die Objektsuche nicht und geben keine Ergebnisse zurück.

    • Aktualisieren: Klicken Sie auf das Symbol zum Aktualisieren, um Tabellen vom Datenbankendpunkt zu laden oder neu zu laden. Dies ist erforderlich, um Objekte initial zu laden. 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.

    • Schema/Besitzer in Tabellennamen einschließen: 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.

    • Tabelle(n) auswählen: 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 aus Tabellen, Ansichten und/oder Systemtabellen ausgewählt werden. Falls Sie stattdessen ein einzelnes Objekt ohne Verknüpfungen abfragen müssen, lesen Sie Abfrage einzelner Objekte mit Assistent.

      Tipp

      Falls die Liste auch nach dem Anwenden 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.

        Tipp

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

      • Übergeordnet: Wählen Sie für jedes untergeordnete Objekt, das verknüpft wird, sein übergeordnetes Objekt aus. Dies stellt die Beziehungshierarchie her und hilft bei der Ableitung von Verknüpfungsschlüsseln.

      • Verknüpfungstyp: Wählen Sie nach dem Zuweisen von Verknüpfungsschlüsseln den Beziehungstyp für jedes untergeordnete Objekt aus:

        • Ein oder mehr: Jeder übergeordnete Datensatz muss mindestens 1 untergeordneten Datensatz haben.

        • Genau ein: Jeder übergeordnete Datensatz muss genau 1 untergeordneten Datensatz haben.

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

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

      • Verknüpfungsschlüssel: Klicken Sie für jedes untergeordnete Objekt mit einem ausgewählten Übergeordneten auf den roten Link Zuweisen, um Schlüsselbeziehungen einzurichten:

  • Link Keys: Sobald ein Objekt als Parent ausgewählt wird, erscheint auf jedem untergeordneten Objekt, das verknüpft wird, 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 Parent-Objekt und seine Felder auf der linken Seite an. Primärschlüssel haben ein Schlüsselsymbol. Verwenden Sie das Suchfeld, um Felder bei Bedarf zu filtern.

    • Child object: Zeigt das Child-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 Parent zum Child (oder umgekehrt), um eine Verknüpfung zu erstellen. Wiederholen Sie dies für mehrere Keys.

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

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

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

  • Remove: Um ein ausgewähltes Objekt aus der Tabelle zu entfernen, fahren Sie über die rechte Spalte und klicken Sie auf das Löschsymbol.

  • Save & Exit: Falls 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 zu wechseln. Diese Schaltfläche wird erst aktiviert, nachdem Sie Parent-Objekte angegeben, den Join Type festgelegt und Link Keys zugewiesen haben. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Finished im letzten Schritt klicken.

  • Skip Wizard / Write SQL Statement: Wechseln Sie zum manuellen Schreiben einer benutzerdefinierten SQL-Anweisung.

    Hinweis

    Das Speichern einer benutzerdefinierten SQL-Anweisung überschreibt alle zuvor gespeicherten Wizard-Abfragen.

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

Step 2: Add conditions

Tipp

Felder mit einem Variablensymbol 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 klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Source: Zeigt Felder für jedes ausgewählte Objekt an. Felder, die als Keys identifiziert wurden, müssen enthalten sein.

    • Search: 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 berücksichtigt keine Groß- und Kleinschreibung. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

    • Select All: Aktivieren Sie das Kontrollkästchen, um alle sichtbaren Objekte und Felder auf einmal auszuwählen (reduzierte Objekte werden nicht ausgewählt). Dieser Auswahlmodus ist nicht verfügbar, wenn Auswahlmöglichkeiten auf Objektebene verwendet werden, ist aber verfügbar, wenn das Suchfeld verwendet wird.

    • Select fields: Aktivieren Sie die Kontrollkästchen der Felder, 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.

  • Table of object fields: Die ausgewählten Objekte und ihre Felder werden in Tabellen auf der rechten Seite angezeigt, mit optionalen Feldern zum Hinzufügen von Bedingungen und Sortierung:

    • Filter Condition: Geben Sie optional eine Bedingung in Form des Arguments einer WHERE-Klausel ein, d. h. Operator(en) gefolgt von Wert(en). Es gibt Beispiele für WHERE-Klauseln auf den How-to-Seiten, die beschreiben, wie man sich mit häufig verwendeten Datenbanken verbindet.

      Vorsicht

      Wenn Sie eine WHERE-Klausel manuell eingeben, 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 Skript-Testen zu ermöglichen. Ohne Standardwerte kann das Testen fehlschlagen, da globale Variablen ihre Werte nur zur Laufzeit erhalten.

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

    Vorsicht

    Die Verwendung von ORDER BY für untergeordnete Felder beeinflusst auch die übergeordneten Datensätze.

  • 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 im letzten Schritt klicken.

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

Schritt 3: Überprüfen Sie das Datenschema

  • Datenschema: Das Quelldatenschema 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

    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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Manuelle Abfrage

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

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 Datenbankaktivität Abfrage 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 Tabellen in Ihrer SQL-Anweisung an.

  • Weiter: Diese Schaltfläche sollte nicht aktiviert sein, da sie nur bei Verwendung des Datenbankabfrage-Assistenten anwendbar ist (siehe Einzelobjekt-Abfrage mit Assistent oder Mehrfachobjekt-Abfrage mit Assistent).

  • Assistent überspringen / SQL-Anweisung schreiben: Klicken Sie, um zum SQL-Eingabeschritt zu wechseln.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung 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 ANSI-SQL-konforme Syntax für den JDBC-Treiber Ihrer spezifischen Datenbank.

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

      Hinweis

      Eine Problemumgehung für SQL-Anweisungen, die die Zeichenbegrenzung ü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 mit eckigen Klammern ein.

  • Beim Verwenden von globalen Variablen in einer WHERE-Klausel geben Sie einen Standardwert mithilfe der Inline-Syntax an (z. B. [customer_id{123}]), um das Testen von Skripten zu ermöglichen. Ohne Standardwerte kann das Testen fehlschlagen, da globale Variablen ihre Werte erst zur Laufzeit erhalten. Beispiele für WHERE-Klauseln finden Sie auf den Seiten mit Anleitungen, die beschreiben, wie man sich mit häufig verwendeten Datenbanken verbindet.

  • Beim Einrichten einer SQL-Anweisung in einem Skript vor dieser Aktivität können Variablen mit anderen Zeichenketten verkettet werden, um gültiges SQL zu erstellen. Beispiel: "SELECT * FROM " + $databaseName + ".Table". Die resultierende Zeichenkette kann dann in einer anderen Variablen gespeichert und direkt auf 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.

  • Sie können benutzerdefinierte Funktionen (UDF) in der SQL-Anweisung mithilfe der Funktion <UDF> verwenden. Diese Funktion ermöglicht die Verwendung beliebiger Datenbankfunktionen, die von der Zieldatenbank unterstützt werden, z. B. die Funktion TO_DATE in Oracle oder die Funktion CONVERT() in SQL Server. Weitere Informationen finden Sie unter Datenbankfunktionen.

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

  • Test Query: Validiert die Abfrage. Falls ungültig, werden Fehlermeldungen angezeigt. Falls gültig, werden bis zu 20 Beispieldatensätze angezeigt.

Schritt 3: Überprüfen Sie das Datenschema

  • Data Schema: Das Quelldatenschema wird angezeigt. Falls der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Quellobjekte, Skripte, Variablen, benutzerdefinierte Werte und mehr Zielfeldern 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.

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

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

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

Nächste Schritte

Nach der Konfiguration einer Datenbankaktivität Query können Sie diese wie unten beschrieben in einem Vorgang oder Skript verwenden.

Schließen Sie den Vorgang ab

Nach der Konfiguration einer Datenbankaktivität Query schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgängsschritte hinzufügen und konfigurieren. Sie können auch die Vorgängseinstellungen 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 Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Activity actions" in Connector basics.

Datenbankaktivitäten Query können mit diesen Vorgängsmustern als Quelle verwendet werden:

Andere Muster sind bei Database Query-Aktivitäten nicht zulässig. 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 Loop-Knoten, um alle Datensätze zu durchlaufen (siehe Loop nodes unter Data structures).

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 Operation-Protokolle.

Database-Aktivitäten in Skripten verwenden

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

Jitterbit Script Functions

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

JavaScript Jitterbit Functions

  • Jitterbit.DbExecute
  • Jitterbit.DbLookup

Weitere Informationen zum Referenzieren von Endpunkten in Skripten finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Chunking verwenden

Wenn man Chunking bei einer Operation verwendet, bei der die Quelle eine Database-Aktivität ist, werden die Daten in der Transformation aufgeteilt, nicht beim Abrufen der Daten. Die Zieldaten werden zunächst in zahlreiche temporäre Dateien geschrieben (eine für jeden Chunk). Diese Dateien werden dann zu einer Zieldatei kombiniert.

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