PPQL-Datenschicht
PPQL (PurePower Query Language) ist die Datenschicht der PurePower Engine. Plugins und Rahmenwerk sprechen die Datenbank nie direkt an, sondern über PPQL — eine SQL-ähnliche Sprache, die dieselbe Anweisung auf MariaDB, SQLite, PostgreSQL und einem Verzeichnis voller CSV-Dateien ausführt, mit demselben Ergebnis. Und weil jede Abfrage durch dieselbe Schicht geht, prüft PPQL dort auch die Rechte: Namensräume, Projektrechte, Grants und Feldregeln.

Eine PPQL-Abfrage im Abfragewerkzeug der Systemeinstellungen: Ressourcen der Reservierung mit der Zahl ihrer Buchungen.
So sieht PPQL aus
Wer SQL kennt, liest PPQL sofort. Tabellen tragen den Namensraum ihres Plugins, Werte kommen immer als Parameter, und Rechte stehen als Makro in der Abfrage:
SELECT i.ticket_key, i.title
FROM tickets:items i
WHERE i.status = :status
AND @rbac_project(i.project_id)
ORDER BY i.created_at DESC
LIMIT 50
tickets:itemsist die Tabelleitemsdes Plugins tickets;@userseine Tabelle des Rahmenwerks.:statuswird gebunden, nie in den Text kopiert — SQL-Injection ist ausgeschlossen.@rbac_project(…)lässt nur Zeilen der Projekte durch, in denen der Betrachter berechtigt ist;@darf('wiki:admin')fragt ein Recht ab,@current_userund@nowsetzt die Anlage ein.- Ein Plugin bekommt nur PPQL-Fehlermeldungen zu sehen, nie das erzeugte SQL oder einen Text der Datenbank.
Eine Sprache, vier Quellen
Massstab ist das Ergebnis auf MariaDB. Wo sich Datenbanken unterscheiden, gleicht PPQL aus: Division und Rundung, Dezimalzahlen mit fester Stellenzahl, Datumsrechnung mit INTERVAL, JSON-Funktionen, Text- und Sortierfolge (Gross/Klein und Akzente egal), strenge Prüfung beim Schreiben. Dieselben Prüfreihen laufen gegen alle vier Quellen und müssen überall dasselbe liefern.
- MariaDB für den Betrieb, SQLite für Entwicklung und kleine Anlagen, PostgreSQL als vollwertige Alternative.
- CSV: Ein Verzeichnis mit CSV-Dateien verhält sich wie eine Datenbank — lesen, schreiben, Transaktionen, Schlüssel und Fremdschlüssel. Die Dateien bleiben gewöhnliche CSV-Dateien, die man weiter in Excel öffnet, auch im deutschen Zahlenformat.
- Ein Plugin kann Daten als CSV in seinem Paket mitbringen und per PPQL lesen — etwa Vorlagen, ganz ohne eigenen Code.
Rechte in jeder Abfrage
- Namensräume: Ein Plugin liest und schreibt nur seine eigenen Tabellen. Fremde Tabellen nur, wenn das Manifest sie in
<ppql_access>nennt, oder über eine Sicht, die das andere Plugin ausdrücklich veröffentlicht — mit genau den Spalten, die es freigibt. - Zonen: Dieselbe Tabelle in der Zone
searchoderreportist nur lesbar, mit Pflicht zum Rechtefilter; die Zonepublicnur mit hinterlegtem Filter. - Grenzen:
UPDATEundDELETEohneWHEREwerden abgewiesen; JOINs, UNION, Unterabfragen und Länge sind begrenzt. - Feldregeln: Einzelne Spalten lassen sich für Konten ohne ein bestimmtes Recht sperren oder maskieren — auch Filter und Sortierung nach einer maskierten Spalte werden abgewiesen, damit sich der Wert nicht erschliessen lässt.
- Feld-Protokoll: Für eingeschaltete Tabellen hält PPQL jede Änderung je Feld fest — alter Wert, neuer Wert, Benutzer, Zeitpunkt und Weg (Seite, API, MCP, Pipeline). Scheitert das Protokoll, wird die Änderung abgelehnt.
Grants und Policies
Für Daten, bei denen Projektrechte nicht reichen, kennt PPQL GRANT und REVOKE mit einer Policy als Zeilenfilter:
GRANT READ, WRITE ON tickets:items TO GROUP :gruppe
WHERE project_id = :projekt
- Ist eine Tabelle grant-pflichtig geschaltet, sieht jeder nur noch Zeilen, die ein Grant für ihn, seine Gruppe oder seinen Mandanten deckt — in jedem JOIN und jeder Unterabfrage. Auch der Superadmin braucht dann einen Grant.
- Ein
UPDATEkann eine Zeile nicht aus dem eigenen Bereich schieben, einINSERTausserhalb wird abgelehnt. - Weitergeben darf nur, wer selbst
ADMINauf mindestens denselben Bereich hat. - Vor dem Einschalten zeigt eine Vorschau, wer heute Zugriff hätte und keinen Grant bekäme. Jedes GRANT, REVOKE und Umschalten steht im Audit-Protokoll, ebenso jeder abgelehnte Versuch.

Migrationen der Plugins
Ein Plugin legt seine Tabellen mit PPQL an, nicht mit dem SQL einer bestimmten Datenbank. Die Migrationen stehen als nummerierte Dateien im Paket und im Manifest; die Anlage führt jede beim Laden genau einmal aus — auf MariaDB, SQLite oder PostgreSQL aus derselben Datei.
-- migrations/003_teile.ppql
CREATE ENTITY reservierung:teile (
id INTEGER PRIMARY KEY AUTO,
gesamt_id INTEGER NOT NULL,
teil_id INTEGER NOT NULL,
UNIQUE (gesamt_id, teil_id)
);
CREATE INDEX reservierung:teile(teil_id);
Ein eigenes Typsystem (INTEGER, BIGINT, DECIMAL(p,s), DATETIME, JSON, UUID …) wird je Datenbank übersetzt. ALTER ENTITY fügt Spalten hinzu, ändert Typen und legt nachträglich CHECK, UNIQUE und Fremdschlüssel an — vorhandene Zeilen werden dabei geprüft.
PPQL überall
Dieselbe Sprache steckt in den Listen und Filtern der XUI-Oberfläche, im Pipeline-Knoten für Abfragen und im Code der Plugins, gleich in welcher Programmiersprache sie geschrieben sind. Das Abfragewerkzeug in den Systemeinstellungen führt PPQL für Diagnose und Auswertung direkt aus.
Zurück zur PurePower Engine.
Fragen zu PPQL-Datenschicht?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.