Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Datenbankabfrageaktivität

Einführung

Eine Datenbank-Abfrage-Aktivität unter Verwendung ihrer Datenbankverbindung, fragt Daten von einem Endpoint ab und soll als Quelle zum Bereitstellen von Daten in einer Operation verwendet werden.

Erstellen einer Datenbankabfrageaktivität

Eine Instanz einer Datenbank-Abfrage-Aktivität wird aus einer Datenbankverbindung erstellt mithilfe des Aktivitätstyps Abfrage.

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

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

Konfigurieren einer Datenbankabfrageaktivität

Führen Sie die folgenden Schritte aus, um eine Datenbank-Abfrage-Aktivität zu konfigurieren:

  • Um nur ein einzelnes Objekt ohne Verknüpfungen Abfrage, wenn die SQL-Anweisung unbekannt ist, lesen Sie Abfrage mit Assistent.

  • Informationen zum Abfrage mehrerer Objekte mit Verknüpfungen, wenn die SQL-Anweisung unbekannt ist, finden Sie unter Abfrage mehrerer Objekte mithilfe des Assistenten.

  • Informationen zum Abfrage einzelner oder mehrerer Objekte durch manuelles Eingeben einer SQL-Anweisung finden Sie unter Manuelle Abfrage. Diese Option ist nur bei Datenbankverbindungen verfügbar, die einen JDBC Driver verwenden, und nicht für Verbindungen, die mit ODBC konfiguriert wurden.

Abfrage mit Assistent

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, lesen Sie stattdessen Mehrere Objekte mit dem Assistenten Abfrage oder wenn Sie die SQL-Anweisung bereits kennen und einen JDBC- Driver verwenden, siehe Manuelle Abfrage.

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

Abfrage 1 einzelnes Objekt

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbank-Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Tabelle(n) auswählen: Dieser Abschnitt zeigt die im Endpoint verfügbaren Tabellen unter Verwendung aller angewendeten Filter an, nachdem Sie den Aktualisieren-Symbol für das erste Laden von Objekten. Wenn die Datenbank viele Objekte enthält, können Sie die Objekte vor dem Aktualisieren mit Anzeigen oder Suchen filtern. Wenn beim Abrufen der Objekte auch nach dem Anwenden von Filtern eine Zeitüberschreitung auftritt, verwenden Sie eine manuelle SQL-Anweisung.

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

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die Liste der Objekte kann automatisch gefiltert werden oder Sie müssen die Liste 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 in das Suchfeld eingegeben werden, die Liste automatisch.

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

        Notiz

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

    • Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol zum Laden oder Neuladen von Tabellen vom Endpoint. 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 haben, die Sie anwenden möchten, bevor Sie Datenbankobjekte abrufen.

    • Schema/Besitzer in Tabellennamen aufnehmen: Aktivieren Sie dieses Kontrollkästchen, um das Schema in die Tabellennamen aufzunehmen. Dies kann nützlich sein, wenn Sie denselben Tabellennamen in mehreren Schemata verwenden (z. B. für Entwicklung und Produktion), damit Sie die Tabelle im richtigen Schema anzeigen und auswählen 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 verknüpft werden müssen, lesen Sie Mehrere Objekte mit Assistent Abfrage.

      Tipp

      Wenn die Liste auch nach Anwenden eines Filters nicht mit verfügbaren Objekten gefüllt wird, wird die Datenbankverbindung ist möglicherweise nicht erfolgreich. 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 Einzelobjektabfragen nicht relevant und diese Felder können nicht bearbeitet werden, außer um das Objekt zu entfernen (fahren Sie mit der Maus über die Spalte ganz rechts und klicken Sie auf Symbol „Entfernen“). Wenn Sie mehrere Objekte abfragen, die verknüpft werden müssen, lesen Sie Mehrere Objekte mit Assistent Abfrage.

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

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

  • Assistenten überspringen / SQL-Anweisung schreiben: Wenn vorhanden, nicht auf die Wörter Assistenten überspringen / SQL-Anweisung schreiben klicken. Dadurch werden alle in diesem Schritt ausgewählten Objekte ignoriert und stattdessen wird im nächsten Schritt eine SQL-Anweisung verwendet, die alle hier getroffenen Auswahlen überschreibt.

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

Schritt 2: Bedingungen hinzufügen

Abfrage 2 einzelnes Objekt

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

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

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

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

    • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die in die Abfrage aufgenommen werden sollen, damit sie automatisch zur SQL-Anweisung rechts hinzugefügt werden. Wenn 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 Abfrage wird automatisch mit dem Objekt und allen links 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. Beispiele für WHERE-Klauseln finden Sie auf den Anleitung mit einer Beschreibung, wie Sie eine Verbindung zu häufig verwendeten Datenbanken herstellen. Nachdem Sie eine WHERE-Klausel hinzugefügt haben, 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 die Dropdown-Liste, um ein Feld aus dem ausgewählten Objekt auszuwählen.

    • Operator: Verwenden Sie die Dropdown-Liste, um den/die entsprechenden Operator(en) auszuwählen:

      Arithmetik
      Operator Beschreibung
      + Hinzufügen
      - Subtrahieren
      * Multiplizieren
      / Teilen
      % Modulo
      Bitweise
      Operator Beschreibung
      & Bitweises UND
      | Bitweises ODER
      ^ Bitweises XOR (Exklusiv-ODER)
      Vergleich
      Operator Beschreibung
      = Gleich
      > Größer als
      \< Kleiner als
      >= Größer als oder gleich
      \<= Kleiner oder gleich
      != Ungleich
      Zusammengesetzt
      Operator Beschreibung
      += Addieren ist gleich
      -= Subtrahieren ist gleich
      *= Multiplizieren ist gleich
      /= Dividieren ist gleich
      %= Modulo ist gleich
      &= Bitweises UND ist gleich
      |*= Bitweises ODER ist gleich
      ^-= Bitweises exklusives ODER ist gleich
      Logisch
      Operator Beschreibung
      ALL TRUE, wenn alle Unterabfragewerte die Bedingung erfüllen
      UND WAHR, wenn alle durch UND getrennten Bedingungen WAHR sind
      ANY TRUE, wenn einer der Unterabfragewerte die Bedingung erfüllt
      BETWEEN TRUE, wenn der Operand innerhalb des Vergleichsbereichs liegt
      EXISTS TRUE, wenn die Unterabfrage einen oder mehrere Datensätze zurückgibt
      IN TRUE, wenn der Operand einem aus einer Liste von Ausdrücken entspricht
      LIKE TRUE, wenn der Operand mit einem Muster übereinstimmt
      NICHT Zeigt einen Datensatz an, wenn die Bedingung(en) NICHT WAHR ist/sind
      ODER WAHR, wenn eine der durch ODER getrennten Bedingungen WAHR ist
      SOME TRUE, wenn einer der Unterabfragewerte die Bedingung erfüllt

    • Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll.

      Tipp

      Bei der Verwendung globaler Variablen in einer WHERE-Klausel wird empfohlen, einen Standardwert anzugeben, damit Script möglich sind. Da globale Variablen ihren Wert andernfalls zur Laufzeit erhalten, kann die Syntax während des Tests ungültig werden, wenn kein Standardwert angegeben wird.

    • Hinzufügen: Erstellt die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert. Die automatisch erstellte Klausel wird im unteren Textfeld angezeigt.

    Achtung

    Wenn Sie eine WHERE-Klausel manuell angeben, müssen Sie sie in der von der Datenbank geforderten Syntax eingeben. Sie können in diesem Abschnitt auch manuell eine ORDER BY-Klausel einfügen. Die Verwendung von ORDER BY für untergeordnete Felder wirkt sich auch auf die übergeordneten Datensätze aus.

    Tipp

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

  • Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu überprüfen, ob die Abfrage gültig ist. Wenn die Abfrage nicht gültig ist, liefern Fehlermeldungen zusätzliche Details. Wenn die Abfrage gültig ist, wird eine Stichprobe von bis zu 20 Datensätzen in einer Tabelle angezeigt, die der unten gezeigten ähnelt:

    Abfrage 2 Einzelobjekt Abfrage

Schritt 3: Überprüfen des Schema

Abfrage 3, einzelnes Objekt

  • Datenschema: Das Schema wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt.-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    Notiz

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

  • Zurück: Klicken Sie hier, 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Abfrage mehrerer Objekte mit dem Assistenten

Befolgen Sie diese Schritte, wenn Sie mehrere Objekte abfragen und Verknüpfungen zwischen ihnen erstellen. Wenn Sie ein einzelnes Objekt Abfrage müssen, lesen Sie Abfrage mit Assistent, oder wenn Sie die SQL-Anweisung bereits kennen und einen JDBC- Driver verwenden, siehe Manuelle Abfrage.

Schritt 1: Namen eingeben und Objekte auswählen

Abfrage 1 mehrere Objekte

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbank-Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Tabelle(n) auswählen: In diesem Abschnitt werden die im Endpoint verfügbaren Tabellen unter Verwendung aller angewendeten Filter angezeigt, nachdem Sie den Aktualisieren-Symbol für das erste Laden von Objekten. Wenn die Datenbank viele Objekte enthält, können Sie die Objekte vor dem Aktualisieren mit Anzeigen oder Suchen filtern. Wenn beim Abrufen der Objekte auch nach dem Anwenden von Filtern eine Zeitüberschreitung auftritt, verwenden Sie eine manuelle SQL-Anweisung.

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

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die Liste der Objekte kann automatisch gefiltert werden oder Sie müssen die Liste 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 in das Suchfeld eingegeben werden, die Liste automatisch.

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

      Notiz

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

    • Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol zum Laden oder Neuladen von Tabellen vom Endpoint. 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 haben, die Sie anwenden möchten, bevor Sie Datenbankobjekte abrufen.

    • Schema/Besitzer in Tabellennamen aufnehmen: Aktivieren Sie dieses Kontrollkästchen, um das Schema in die Tabellennamen aufzunehmen. Dies kann nützlich sein, wenn Sie denselben Tabellennamen in mehreren Schemata verwenden (z. B. für Entwicklung und Produktion), damit Sie die Tabelle im richtigen Schema anzeigen und auswählen 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 der Tabelle auf der rechten Seite hinzuzufügen. Es kann jede beliebige Kombination von Tabellen, Ansichten und/oder Systemtabellen ausgewählt werden. Wenn Sie stattdessen ein einzelnes Objekt ohne Verknüpfungen Abfrage müssen, lesen Sie stattdessen Abfrage mit Assistent.

      Tipp

      Wenn die Liste auch nach Anwenden eines Filters nicht mit verfügbaren Objekten gefüllt wird, wird die Datenbankverbindung ist möglicherweise nicht erfolgreich. 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 unten detailliert beschrieben:

      Datenbank mehrere Objekte Tabelle 1

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

        !!! tip "Tipp" Tabellen mit Sonderzeichen wie + in ihren Namen erfordern eine manuelle Abfrage. Der Tabellenname muss in eckige Klammern eingeschlossen sein ([ ]). Zum Beispiel, SELECT * FROM [table+].

      • Übergeordnetes Objekt: Wählen Sie bei jedem verknüpften untergeordneten Objekt über die Dropdown-Liste den Namen des Objekts aus, das das übergeordnete Objekt sein soll. Dies ist erforderlich, um die Transaktionsintegrität eines Objekts zu erzwingen und die Verknüpfungsschlüssel für ein untergeordnetes Objekt abzuleiten.

      • Verknüpfungstyp: Bei jedem verknüpften untergeordneten Objekt wird eine Dropdown-Liste verfügbar, nachdem Sie Verknüpfungsschlüssel zugewiesen haben (wird als Nächstes behandelt). Verwenden Sie die Dropdown-Liste, um die Art der Beziehung zwischen den ausgewählten Objekten festzulegen:

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

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

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

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

      • Link-Schlüssel: Sobald bei jedem verknüpften untergeordneten Objekt ein Objekt als übergeordnetes Objekt ausgewählt wird, erscheint in diesem Feld ein roter Zuweisen-Link. Klicken Sie auf Zuweisen, um ein separates Fenster zu öffnen, in dem Sie die Link-Schlüssel zuweisen:

        Datenbank Link-Schlüssel zuweisen

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

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

        • Linkschlüssel zuweisen: Um ein Feld als Linkschlüssel zuzuweisen, ziehen Sie ein Feld vom übergeordneten Objekt links in ein Feld innerhalb des untergeordneten Objekts rechts oder umgekehrt. Um mehrere Linkschlüssel zuzuweisen, wiederholen Sie diesen Vorgang nach Bedarf.

        • Linkschlüssel aufheben: Um die Zuweisung von Linkschlüsseln aufzuheben, klicken Sie auf ein beliebiges Feld, das bereits verknüpft wurde. Die verknüpften Felder werden dadurch abgewählt.

        • Von vorne beginnen: Um alle zugewiesenen Linkschlüssel zu löschen, klicken Sie links unter der übergeordneten Liste auf Von vorne beginnen.

        • Fertig: Klicken Sie auf Fertig, um die zugewiesenen Linkschlüssel zu speichern und das Fenster zu schließen. Unter Linkschlüssel sollte nun die Anzahl der zugewiesenen Linkschlüssel angezeigt werden. Klicken Sie darauf, um das Fenster zur Linkschlüsselzuweisung erneut zu öffnen. Darüber hinaus steht Ihnen das Dropdown-Menü Jointyp zur Verfügung, in dem Sie den Beziehungstyp (Kardinalität) zwischen den ausgewählten Objekten festlegen können:

          Datenbank mehrere Objekte Tabelle 2

      • Entfernen: Um ein ausgewähltes Objekt aus der Tabelle zu entfernen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und klicken Sie auf Symbol entfernen.

      • Speichern und beenden: Klicken Sie, wenn 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 mit dem nächsten Schritt fortzufahren. Diese Schaltfläche wird erst aktiviert, nachdem Sie alle übergeordneten Objekte angegeben, den Join-Typ festgelegt und Link-Schlüssel zugewiesen haben. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

      • Assistent überspringen / SQL-Anweisung schreiben: Klicken Sie, falls vorhanden, nicht auf die Wörter Assistent überspringen / SQL-Anweisung schreiben. Dies führt dazu, dass alle in diesem Schritt ausgewählten Objekte ignoriert werden und stattdessen im nächsten Schritt eine SQL-Anweisung verwendet wird, die alle hier getroffenen Auswahlen überschreibt.

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

Schritt 2: Bedingungen hinzufügen

Abfrage 2 mehrere Objekte

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Quelle: Dieser Abschnitt zeigt Felder für das ausgewählte Objekt an, die im Endpoint verfügbar sind. Wenn ein Feld von der Datenbank als Schlüssel identifiziert wird, muss dieses Feld eingeschlossen werden.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder für das ausgewählte Objekt zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

    • Alles auswählen: Aktivieren Sie das Kontrollkästchen, um alle sichtbaren Objekte und Felder gleichzeitig auszuwählen (kollabierte Objekte werden nicht ausgewählt). Dieser Auswahlmodus ist nicht verfügbar, wenn Auswahlen auf Objektebene verwendet werden, aber bei Verwendung des Suchfelds.

    • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die in die Abfrage aufgenommen werden sollen, damit sie automatisch zur SQL-Anweisung rechts hinzugefügt werden. Sie können auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen.

  • Tabelle der Objektfelder: Auf der rechten Seite werden die ausgewählten Objekte und ihre Felder tabellarisch angezeigt, mit optionalen Feldern zum Hinzufügen von Bedingungen und zum Sortieren:

    • Filterbedingung: Geben Sie bei Bedarf eine Bedingung in Form des Arguments einer WHERE-Klausel ein, d. h. Operator(en), gefolgt von Wert(en). Beispiele für WHERE-Klauseln finden Sie in den Anleitung mit einer Beschreibung, wie man sich mit häufig verwendeten Datenbanken verbindet.

      Achtung

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

      Tipp

      Bei der Verwendung von globalen Variablen in einer WHERE-Klausel wird empfohlen, einen Standardwert anzugeben, damit ein Script möglich ist. Andernfalls kann die Syntax beim Testen ungültig werden, da globale Variablen ihren Wert zur Laufzeit erhalten, wenn kein Standardwert angegeben wird.

    • Sortieren: Wählen Sie bei Bedarf im Dropdown-Menü zwischen Keine, Aufsteigend oder Absteigend aus, um eine Sortierreihenfolge anzuwenden. Die Auswahl der Option Keine ist dasselbe, als ob Sie dieses Feld leer lassen.

      Achtung

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

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

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

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

Schritt 3: Überprüfen des Schema

Abfrage 3 mehrere Objekte

  • Datenschema: Das Schema wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt.-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    Notiz

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

  • Zurück: Klicken Sie hier, 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Manuelle Abfrage

Führen Sie diese Schritte aus, wenn Sie die SQL-Anweisung für die Abfrage kennen und sie manuell eingeben möchten. Diese Option ist nur bei Datenbankverbindungen verfügbar, die einen JDBC- Driver verwenden, und nicht für Verbindungen, die mit ODBC konfiguriert wurden. Wenn Sie die Anweisung noch nicht kennen oder die Verbindung ODBC verwendet, führen Sie entweder die Schritte Abfrage mit Assistent aus oder Mehrere-Objekt Abfrage mit Assistent oben.

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

Abfrage 1 manuelle Abfrage

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbank-Abfrage-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Tabelle(n) auswählen: Verwenden Sie diesen Abschnitt nicht, da er für manuelle Abfragen nicht relevant ist. Dieser Abschnitt ist nur anwendbar, wenn Sie den Datenbankabfrage-Assistenten verwenden (siehe Abfrage mit Assistent oder Mehrere-Objekt Abfrage mit Assistent). Stattdessen geben Sie die Tabellen (sofern welche erforderlich sind) an, wenn Sie im nächsten Schritt die SQL-Anweisung eingeben.

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

  • Assistent überspringen / SQL-Anweisung schreiben: Klicken Sie auf Assistent überspringen / SQL-Anweisung schreiben, um mit dem nächsten Schritt zur Bereitstellung der manuellen SQL-Anweisung fortzufahren.

    Warnung

    Wenn Sie Tabellen ausgewählt haben, gehen Ihre Auswahlen verloren.

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

Schritt 2: Geben Sie eine SQL-Anweisung ein

Abfrage 2 manuelle Abfrage

  • SQL-Anweisung schreiben oder einfügen: Geben Sie die SQL- Abfrage in das Textfeld ein. Hinweis:

    • Alle SQL-Anweisungen sollten für den JDBC- Driver der Datenbank, auf die Sie zugreifen, ANSI-SQL-kompatibel sein.

    • Die SQL-Anweisung ist auf 2.000 Zeichen begrenzt.

      Hinweis

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

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

    • Bei der Verwendung globaler Variablen in einer WHERE-Klausel empfehlen wir die Angabe eines Standardwerts, damit Script möglich sind. Da globale Variablen ihren Wert zur Laufzeit erhalten, kann die Syntax während des Tests ungültig werden, wenn kein Standardwert angegeben wird. Beispiele für WHERE-Klauseln finden Sie in den How-to-Seiten mit einer Beschreibung der Verbindungsherstellung zu häufig verwendeten Datenbanken.

    • Wenn Sie in einem Script davorlegende dieser Aktivität eine SQL-Anweisung einrichten, können Variablen mit anderen Zeichenfolgen verknüpft werden, um gültiges SQL zu erstellen. Beispiel: "SELECT * FROM " + $databaseName + ".Table". Die resultierende Zeichenfolge kann dann in einer anderen Variable gespeichert und mithilfe der oben genannten Informationen direkt auf dieses Feld angewendet werden.

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

    • Sie können benutzerdefinierte Funktionen (UDF) innerhalb der SQL-Anweisung mithilfe von verwenden.<UDF>-Funktion. Mit dieser Funktion können Sie jede Datenbankfunktion verwenden, die von der Zieldatenbank unterstützt wird, z. B. die TO_DATE Funktion in Oracle oder die CONVERT() Funktion in SQL Server. Einzelheiten finden Sie unter Datenbankfunktionen.

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

  • Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu überprüfen, ob die Abfrage gültig ist. Wenn die Abfrage ungültig ist, liefern Fehlermeldungen zusätzliche Details. Wenn die Abfrage gültig ist, wird eine Stichprobe von bis zu 20 Datensätzen in einer Tabelle angezeigt, die der unten gezeigten ähnelt:

    Abfrage 2 Einzelobjekt Abfrage

Schritt 3: Überprüfen des Schema

Abfrage 3 manuelle Abfrage

  • Datenschema: Das Schema wird angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt.-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    Notiz

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

  • Zurück: Klicken Sie hier, 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 hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, 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 sie wie unten beschrieben innerhalb eines Operation oder Script verwenden.

Schließen Sie den Operation ab

Nachdem Sie eine Datenbank-Abfrage-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü“ in Connector-Grundlagen.

Datenbank-Abfrage-Aktivitäten können mit diesen Operation als Quelle verwendet werden:

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

Wenn Sie innerhalb einer Transformation die Option zum Spiegeln eines Schema verwenden, bereitgestellt durch eine Datenbankaktivität unter Verwendung einer einzelnen Tabelle (ohne Verknüpfungen), wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Knoten namens row. Wenn Felder innerhalb dieses zusätzlichen Knotens zugeordnet werden, wird der Knoten zu einem Schleifenknoten, der das Durchlaufen aller Datensätze ermöglicht (siehe Schleifenknoten unter Datenstrukturen).

Beachten Sie außerdem beim Verknüpfen von Datenbanktabellen, dass 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 Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.

Verwenden von Datenbankaktivitäten in Scripts

Auf Datenbank-Abfrage-Aktivitäten kann auch in einem Script verwiesen werden zur Verwendung mit Script, die eine databaseId als Parameter, einschließlich dieser:

Jitterbit Script Skriptfunktionen

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

JavaScript-Jitterbit-Funktionen

  • Jitterbit.DbExecute- Jitterbit.DbLookup

Weitere Einzelheiten zum Referenzieren von Endpoints in Scripts finden Sie unter Endpoints in Jitterbit Script oder Endpoints in JavaScript.

Verwenden von chunking

Wenn Sie chunking für einen Operation verwenden, dessen Quelle eine Datenbankaktivität ist, werden die Daten bei der Transformation in Chunks aufgeteilt und nicht beim Abrufen. Die Zieldaten werden zunächst in mehrere 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 Operationsoptionen.