Datenbank abfragen (SQL)

Mit dem Plugin Datenbank abfragen (SQL) haben Sie die Möglichkeit, Daten aus einer Datenbank zu lesen. Die Verbindung zur Datenbank wird mit einem Datenbank-Connector hergestellt, der zuvor konfiguriert werden muss.

Parameter "Datenbank-Connector"

Aus diesem Auswahlfeld wählen Sie den Datenbank-Connector aus, der auf die gewünschte Datenbank zeigt.

Parameter "SQL Anfrage"

Hier formulieren Sie die SQL-Abfrage um die Daten auszulesen. Das Feld erlaubt eine Kombination aus Freitext und Variablen.

Parameter "Alle Zeilen einlesen"

Wenn die Option Alle Zeilen einlesen aktiviert ist, werde alle von der Datenbank zurückgelieferten Zeilen eingelesen. Standardmässig ist diese Option deaktiviert, sodass nur die erste Zeile verarbeitet wird. Siehe Beispiele.

Parameter "Ergebnis"

Das Ergebnis der Datenbankabfrage wird in einer Variable vom Typ collection abgespeichert. Jede Spalte wird zu einem Eintrag in der hier ausgewählten Variable.

Parameter "Anzahl betroffener Zeilen"

In diesem Auswahlfeld können Sie eine Variable vom Typ integer auswählen in der gespeichert wird, wie viele Zeilen die SQL Abfrage generiert hat.

Ist die Option Alle Zeilen einlesen deaktiviert, enthält die hier gewählte Variable den Wert 0 oder 1.

Parameter "Ergebnis gefunden (Optional)"

Ob ein Ergebnis gefunden wurde oder nicht kann in einer Variable vom Typ boolean gespeichert werden.

Beispiele

Standardmässig wird nur die erste von der Datenbank zurückgelieferte Zeile verarbeitet. Jede Spalte dieser Zeile wird dabei zu einem Eintrag in einer Collection, die in der im Parameter Ergebnis ausgewählten Variable gespeichert wird.

Ist die Option Alle Zeilen einlesen aktiviert, werden hingegen alle zurückgelieferten Zeilen verarbeitet. Auch in diesem Fall wird das Ergebnis in einer Collection abgespeichert.

Die Tabelle user hat folgenden Inhalt:

ID
Vorname
Nachname
1

John

Doe

2

Jane

Smith

3

Max

Mustermann

Die SQL Abfrage lautet: SELECT * FROM user;

Alle Zeilen einlesen ist deaktiviert

Die Ergebnis-Variable hat folgenden Inhalt: [1, John, Doe]

Es wird nur die erste Zeile verarbeitet, obwohl die Datenbank zwei Zeilen zurückgeben würde.

Alle Zeilen einlesen ist aktiviert

Die Ergebnis-Variable hat folgenden Inhalt: [1, John, Doe, 2, Jane, Smith, 3, Max, Mustermann]

Alle von der Datenbank zurückgelieferten Zeilen werden verarbeitet. Dabei werden zunächst die Spalten der ersten Zeile in die Collection eingefügt, gefolgt von den Spalten der zweiten Zeile und so weiter.

Zuletzt aktualisiert