# Datenbank abfragen (SQL)

Mit dem Plugin <img src="/files/9RDu1Jy7L8BC1WluHybC" alt="" data-size="line"> *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.

<figure><img src="/files/lOvsqEiuaoq7UroaDkkf" alt="" width="291"><figcaption></figcaption></figure>

## 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](#beispiele "mention").

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

<table><thead><tr><th data-type="number">ID</th><th>Vorname</th><th>Nachname</th></tr></thead><tbody><tr><td>1</td><td>John</td><td>Doe</td></tr><tr><td>2</td><td>Jane</td><td>Smith</td></tr><tr><td>3</td><td>Max</td><td>Mustermann</td></tr></tbody></table>

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aiaibot.com/robot/plugins/datenbanken/datenbank-abfragen-sql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.