Abfrage

Einführung

Eine Datenbankabfrage fragt Daten von einem Endpoint ab und soll als Quelle verwendet werden, um Daten für einen Operation bereitzustellen oder in einem Script aufgerufen zu werden. Nachdem Sie eine Datenbankverbindung konfiguriert haben, können Sie für jede Datenbankverbindung beliebig viele Datenbankaktivitäten konfigurieren.

Erstellen einer Datenbankaktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

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ätsinstanz in Komponentenwiederverwendung.

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

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer Abfrage

Die Schritte zum Konfigurieren einer Datenbankabfrageaktivität unterscheiden sich je nach Anwendungsfall und ob Sie die SQL-Anweisung bereits kennen:

• Abfrage mittels Assistent: Befolgen Sie diese Schritte, um nur ein einzelnes Objekt ohne Verknüpfungen Abfrage, wenn die SQL-Anweisung unbekannt ist.
• Mehrere-Objekt Abfrage mit Assistent: Befolgen Sie diese Schritte, um mehrere Objekte mit Verknüpfungen Abfrage, wenn die SQL-Anweisung unbekannt ist.
• Manuelle Abfrage: Befolgen Sie diese Schritte, um einzelne oder mehrere Objekte Abfrage, indem Sie manuell eine SQL-Anweisung eingeben. Diese Option ist nur bei Datenbankverbindungen verfügbar, die einen JDBC- Treiber 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- Treiber verwenden, siehe Manuelle Abfrage.

• Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus
• Schritt 2: Bedingungen hinzufügen
• Schritt 3: Überprüfen Sie das Schema

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

• Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbankabfrageaktivitä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 "Tabellen, Ansichten", "Tabellen", "Ansichten" oder "Systemtabellen" zu filtern. 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

• 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 erstellen, oder Sie können die Klausel manuell in das untere Textfeld eingeben. Beispiele für WHERE-Klauseln finden Sie unter Datenbankspezifische Informationen. 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:

  

Schritt 3: Überprüfen des Schema

• 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- Treiber verwenden, siehe Manuelle Abfrage.

• Schritt 1: Namen eingeben und Objekte auswählen
• Schritt 2: Bedingungen hinzufügen
• Schritt 3: Überprüfen Sie das Schema

Schritt 1: Namen eingeben und Objekte auswählen

• Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbankabfrageaktivitä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 wird möglicherweise automatisch gefiltert, 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 dem 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:

    

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

    • Ü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 durchzusetzen 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 das Dropdown-Menü, um die Art der Beziehung zwischen den ausgewählten Objekten festzulegen:

      • Einer oder mehr: 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 oder nur 1 untergeordneten Datensatz zu haben.

    • Link-Schlüssel: Sobald bei jedem untergeordneten Objekt, das verknüpft wird, ein roter Link Zuweisen in diesem Feld angezeigt wird, sobald ein Objekt als übergeordnetes Objekt ausgewählt wurde. Klicken Sie auf Zuweisen, um ein separates Fenster zu öffnen, in dem Sie die 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.

      • Neu starten: Um alle zugewiesenen Linkschlüssel zu löschen, klicken Sie auf Neu starten unterhalb der übergeordneten Liste links.

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

        

    • Entfernen: Um ein ausgewähltes Objekt aus der Tabelle zu entfernen, bewegen Sie den Mauszeiger über die Spalte ganz rechts und klicken Sie auf das 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

• 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 verfügbar.
  • 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: Die ausgewählten Objekte und ihre Felder werden in Tabellen auf der rechten Seite angezeigt, mit optionalen Feldern zum Hinzufügen von Bedingungen und Sortierungen:

  • 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 unter Datenbankspezifische Informationen.

    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

• 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- Treiber 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
• Schritt 2: Geben Sie eine SQL-Anweisung ein
• Schritt 3: Überprüfen Sie das Schema

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

• Name: Geben Sie einen Namen ein, der zur Identifizierung der Datenbankaktivität verwendet werden soll. Der Name muss für jede Datenbankabfrageaktivitä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.

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

• 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

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

  • Alle SQL-Anweisungen sollten für den JDBC- Treiber 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.

  • Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, empfehlen wir, einen Standardwert anzugeben, 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 unter Datenbankspezifische Informationen.

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

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

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

  

Schritt 3: Überprüfen des Schema

• 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 Datenbankabfrageaktivität konfiguriert haben, können Sie sie wie unten beschrieben in einem Operation oder Script verwenden. Wenn Sie außerdem an die vom Ziel vorgegebenen Datensatzgrenzen stoßen, können Sie chunking verwenden.

Schließen Sie den Operation ab

Nachdem Sie eine Datenbankabfrageaktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine Datenbankabfrageaktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

Datenbankabfrageaktivitäten können mit diesen Operation als Quelle verwendet werden:

• Transformation
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• HTTP-Archivmuster mit zwei Zielen (nur als erste Quelle)
• Zwei-Transformationsmuster (nur als erste Quelle)

Andere Muster sind bei Verwendung von Datenbankabfrageaktivitä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 Knoten und Felder).

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, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.

Verwenden von Datenbankaktivitäten in Scripts

Auf Datenbankabfrageaktivitä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.