SQL-Editor

Der SQL-Editor ermöglicht es Ihnen, eigene Abfragen in der Polyteia-Plattform zu schreiben, um Datensätze zu erkunden.

Er ist nützlich, wenn Sie mehr Kontrolle benötigen, als der visuelle Builder bietet. Sie können Spalten auswählen, Filter hinzufügen und Ergebnisse genau nach Ihren Wünschen gruppieren oder sortieren. Der Editor verwendet DuckDB SQL-Syntax.

Um eine Abfrage auszuführen, müssen Sie zuerst einen Datensatz auswählen und Ihre Abfrage immer mit einem LIMIT beenden. Die maximale Zeilenanzahl für Abfragen beträgt 10.000.

SQL-Editor öffnen

Sie können in den SQL-Modus von jeder Auswertung aus wechseln:

• Gehen Sie zum Reiter Daten

• Klicken Sie auf die Schaltfläche SQL neben No-code

Dies öffnet einen Texteditor, in dem Sie Ihre SQL-Abfrage schreiben können.

Datensatz auswählen

Sie müssen immer definieren, auf welchem Datensatz die Abfrage ausgeführt werden soll.

• Klicken Sie auf das Dropdown-Menü mit der Bezeichnung Verfügbare Datensätze

• Kopieren Sie die Datensatz-ID mit der Schaltfläche Kopieren

• Fügen Sie sie in Ihren SQL-Code ein

Beispiel:

select *
from '{{ds_abc123xy456}}' as "Beispiel-Datensatz"
limit 1000

Wichtig: Fügen Sie immer LIMIT am Ende Ihrer Abfrage hinzu. Die Abfrage wird ohne diesen Befehl nicht ausgeführt. 1000 ist die maximale Anzahl der Zeilen für die Abfrage.

Eigene Abfrage schreiben

Sobald der Datensatz ausgewählt ist, können Sie jede gültige DuckDB SQL-Abfrage schreiben.

Beispiel: Auswählen und zählen

select department, count(*) as total
from '{{ds_abc123xy456}}'
group by department
order by total desc
limit 1000

Dieses Beispiel zählt, wie viele Zeilen für jede Abteilung existieren und sortiert sie von hoch nach niedrig.

Datensatz-Schema erkunden

Unterhalb des Editors sehen Sie eine Liste der Spalten für den ausgewählten Datensatz. Jede zeigt:

• Den Spaltennamen

• Den Datentyp (wie VARCHAR, DATE, DOUBLE, etc.)

Nutzen Sie diese, um gültige Abfragen zu schreiben, ohne Spaltennamen erraten zu müssen.

Beispieltypen:

Spaltenname	Typ	Bedeutung
Name	VARCHAR	Textwerte
Startdatum	DATE	Datum für Filterung
Alter	BIGINT	Ganze Zahl
Vollzeitäquivalent	DOUBLE	Dezimalzahl

Häufige SQL-Klauseln

Sie können alle standardmäßigen DuckDB-Klauseln verwenden. Hier ist eine kurze Übersicht:

Klausel	Funktion
select	Wählen Sie anzuzeigende Spalten
from	Definieren Sie den Datensatz
where	Zeilen filtern (z. B. where age > 30)
group by	Daten zusammenfassen (z. B. Summen pro Kategorie)
order by	Zeilen sortieren (z. B. order by name asc)
limit	Immer erforderlich, begrenzt die Anzahl der Zeilen

Abfragevalidierung

Alle SQL-Abfragen werden vor der Ausführung validiert. Das System überprüft Ihre Abfrage, um sicherzustellen, dass sie sicher ist und den Plattformregeln entspricht.

Operationen, die Daten ändern, löschen oder beschädigen könnten - wie DROP, DELETE, UPDATE oder das Erstellen neuer Tabellen - sind nicht erlaubt. Wenn das System etwas Ungültiges oder Unsicheres erkennt, wird die Abfrage nicht ausgeführt.

Dies stellt sicher, dass im Editor nur sichere und schreibgeschützte Operationen möglich sind.

Eine vollständige Liste der verfügbaren SQL-Funktionen mit Beispielen finden Sie in unserer SQL-Befehle Referenz.

Abfrage ausführen

Klicken Sie auf die Schaltfläche Ausführen, um Ihre Abfrage zu starten. Die Ergebnisse werden in der Tabelle links angezeigt.

Wenn nichts angezeigt wird:

• Überprüfen Sie Tippfehler in den Spaltennamen

• Stellen Sie sicher, dass die Datensatz-ID korrekt ist

• Bestätigen Sie, dass Sie limit 1000 hinzugefügt haben

Wenn die Tabelle immer noch leer ist, könnte Ihre Abfrage basierend auf den Filtern keine Zeilen zurückgeben.

Zurück zum visuellen Modus wechseln

Möchten Sie den Builder wieder verwenden?

• Klicken Sie auf No-code neben SQL

• Dies setzt Ihre Abfrage zurück und kehrt zur Drag-and-Drop-Oberfläche zurück

Hinweis: Sie verlieren Ihre aktuelle SQL-Abfrage, wenn Sie wechseln.