SQL-Brücke / Wrapper
HTTP-API auf 127.0.0.1, offene Datenbanksitzung, Login-Cookie, Platzhalterprüfung. Nicht neu erfinden.
Pipeline-Labor: Stage leeren, nachdem ODS geliefert hat
Offene Bastelanleitung. Die SQL-Brücke (Wrapper, Interface) gilt als vorhanden. Nachgebaut werden Maske und Queries. Der Webserver lauscht nur auf Localhost, also 127.0.0.1 — nicht im Netz.
Kafka, also der Nachrichtenstrom, landet in der Stage, also der S_-Tabelle. Der ODS, also Operational Data Store, die O_-Tabelle, hält die gelieferten Daten. Eine VIEW liest den ODS und speichert nichts. Erst wenn Gates, also Prüfschranken, grün sind, darf Stage geleert werden.
Option A löscht die fällige Partition sofort. Option B tauscht sie per Exchange Partition, also EXCHANGE PARTITION, Partitionstausch, in den Trash und erlaubt Restore, also Rückholen, in der Karenz, also der Wartezeit. Tabellennamen auf den Grafiken sind Platzhalter. Die Felder bleiben.
Maske
Zuerst die Oberfläche, als SVG nachgezeichnet
Inhalte und Reihenfolge sind bindend. Pixelgenaue Positionen nicht. Labor ohne Kundendaten, ohne echte IP, ohne Passwort.
Maske + Queries
HTML-IDs, CSS-Zustände opt-a/opt-b, JavaScript für Dry Run und Purge, Package mit Planfunktion.
Nur Localhost
Bind 127.0.0.1, kein 0.0.0.0, kein CORS-Stern, kein Passwort im Code. Die Datenbank darf eine andere Maschine sein.
Zusammenspiel
HTML, CSS, JavaScript und SQL
HTML nennt IDs. CSS malt Zustände (Option A/B, Gate-Ampel, fällige Zeile).
JavaScript liest Retention und Modus, füllt Platzhalter der Form
${Name: Default} und ruft die Brücke.
SQL entscheidet fachlich. Der Browser erfindet keine Purge-Regel, die das Package nicht kennt.
| Schicht | Tut | Gibt zurück |
|---|---|---|
| GET /api/session | Sitzung prüfen | connected, expires_in_s, user, schema — ohne Session keine Personendaten |
| POST /api/connect | Host, Port, Dienst, User, Passwort | ok, Instanz, Connect-ms, Cookie HttpOnly |
| POST /api/run | SQL plus params | ok, results[].rows, status, runtime |
| GET /api/script/… | Datei aus sql/ oder sql_local | ok, sql, source |
| FN_PURGE_PLAN | einzige Entscheidungsquelle | part_name, gate1_ok, gate2_ok, in_trash, eligible, aktion |
Exchange Partition
Hinweg und Rückweg über SWAP
Zwei partitionierte Tabellen tauschen nicht direkt. Dazwischen liegt SWAP: unpartitioniert, strukturgleich, danach wieder leer.
Hinweg: Stage mit SWAP tauschen, dann Trash mit SWAP tauschen. Stage-Partition ist leer, Trash-Partition voll, SWAP leer. Log-Schritt PURGE_B_ENDE. Rückweg: dieselbe Reihenfolge rückwärts. Stage-Partition muss leer sein, sonst kein Restore. Option A braucht keinen SWAP: DROP, TRUNCATE oder DELETE, kein Restore.
ORA-14097 bedeutet abweichende Spalten (Generated versus gespeichert, andere Reihenfolge). Interval-Tabellen behalten die Ankerpartition P_ANCHOR, sonst ORA-14758.
Edge Cases
Sieben Karten, die Annahmen knacken
| Karte | Absicht | Erwartung |
|---|---|---|
| Bestand identisch | O_ aus S_ füllen | IDENTISCH grün, Purge erlaubt |
| ODS hat mehr | Extra-Zeilen in O_ | IDENTISCH rot, ODS_MEHR grün |
| ODS hat weniger | Zeilen in O_ löschen | IDENTISCH rot, ODS_WENIGER grün |
| Hash abweichend | Payload in O_ ändern | IDENTISCH blockiert trotz gleicher Zählung |
| Stage leer | S_ leeren | Gate 1 ohne fällige Zeilen |
| Trash voll | gleicher Tag schon im Trash | Option B überspringt Exchange |
| Reset | S_, O_, TRASH_, LOG_ leeren | Grafik auf null |
Sperrliste
Damit die bekannten Fehler nicht wiederkommen
- HTML als Datei öffnen (file://) statt http://127.0.0.1 — die Brücke antwortet nicht.
- Localhost der Brücke mit der Datenbank-IP verwechseln. Nur die Brücke ist 127.0.0.1.
- Exchange direkt zwischen zwei partitionierten Tabellen. Immer SWAP dazwischen.
- Gate 2 über die ganze Tabelle statt über den Kalendertag der Partition.
- Dry Run und Job mit verschiedenem Code. Eine Planfunktion, Parameter p_dry_run nur für die Ausgabe.
- Datenbankfelder ungeescapet in innerHTML. XSS. Immer escapen.
- System-Query cutoff fehlt, wenn die Ansicht vor dem Laden der Query-Datei aktualisiert wird.
30 Prozent
Bastelreihenfolge
- Brücke starten, Bind 127.0.0.1 prüfen.
- Objektnamen mappen. Spalten nicht umbenennen.
- Maske mit den Zonen aus Abbildung 1 und 2. CSS für opt-a und opt-b.
- JavaScript: api, System-SQL parsen, Overview, Gates, Dry Run, Purge, Restore, esc.
- Package: Plan, Purge A/B mit SWAP, Restore rückwärts, Clear Trash nach Karenz.
- Sieben Testkarten. Abnahme: Dry Run und Job zeigen dieselbe nächste Partition.
Weglassen darf man die zweite Kachel-UI, Spielereien auf den Kanten und das Speichern des Dashboard-Zustands. Das Konzept bleibt.
Labor gesehen — Migration im Bestand?
Dasselbe Denken steckt in unseren Werkzeugen für Cognos und DataStage: sichtbar machen, prüfen, dann erst ändern. Kurztermin in Bonn oder remote.