Storage Plugin
Storage ist der SQLite-Dienst der WvdS-Paketfamilie: eine Datenbank, vorbereitete Anweisungen, Transaktionen, vereinheitlichte Fehler und ein versionierter Migrationslauf mit Sicherung. Fachliche Tabellen legt er ausdrücklich nicht an. Gedacht ist das Paket für Plugin-Entwickler, die strukturierte Daten ablegen, und für Verwalter, die wissen müssen, wo die Datei liegt und wie eine Migration verläuft.
Erste Schritte
Schnelleinstieg: Migration, Transaktion und Lesevorgang ausführen — der kürzeste Weg zum ersten Ergebnis, in zwei Schritten, ohne Code.
Ablageort prüfen → Migrationsstand ansehen → Diagnose ausführen
Häufige Aufgaben
| Was Sie wollen | Für wen | Wo Sie das tun | Anleitung |
|---|---|---|---|
| nachsehen, wo die Datenbank liegt | Verwaltung | – | Ablage auf dieser Instanz |
| den Zustand der Ablage prüfen | Verwaltung | do=wkstorage_diag | Diagnose |
| eine Migration nachvollziehen | Verwaltung | – | Migrationen |
| entscheiden, ob Daten hierher gehören | Entwickler | – | Zweck |
| eine Einstellung ändern | Verwaltung | Konfigurationsmanager | Konfiguration |
| die fachlichen Tabellen der DevOps-Suite finden | Entwickler | – | wkdostorage |
Zweck
Der SQLite-Dienst der WvdS-DW-Familie. Er stellt genau eine Datenbank bereit, dazu vorbereitete Anweisungen, Transaktionen, vereinheitlichte Fehler und einen versionierten Migrationslauf mit Sicherung. Fachliche Tabellen legt er nicht an — das tut DevOps Storage Plugin darauf.
Angemeldeter Dienst: storage.sqlite (siehe Core Plugin).
Was in die Datenbank gehört — und was nicht
Ablage auf dieser Instanz
| Was | Wo |
|---|---|
| Datenbank | data/dwdo/dwdo.sqlite |
| Sicherungen des Migrators | data/dwdo/backup/ |
| Schemastand | 010 (10 angewandte Migrationen) |
Der Pfad leitet sich vom konfigurierten savedir ab, ist also portabel — die Instanz lässt
sich mitsamt Datenbank kopieren. Er liegt getrennt von data/meta/, wo andere Plugins ihre
eigenen SQLite-Dateien halten; eine Kollision ist ausgeschlossen.
dwdo.sqlite — nicht dwdo.sqlite3. Wer sie von Hand sucht (etwa mit dem
SQLite-Datenquellen-Plugin), findet sonst nichts und schließt fälschlich
auf eine fehlende Einrichtung.
Migrationen
Der Migrator führt die Schemaschritte in fester Reihenfolge aus und schreibt jeden angewandten
Stand nach schema_migrations. Vor dem Lauf legt er eine Sicherung an. Ein Schritt, der
fehlschlägt, bricht den Lauf ab — halb angewandte Schemata gibt es nicht.
Die Schrittdateien gehören zum jeweiligen fachlichen Plugin, nicht hierher: dieses Plugin kennt den Ablauf, nicht die Tabellen.
Diagnose
?do=wkstorage_diag — meldet Pfad, Erreichbarkeit und Schemastand. Erste Anlaufstelle,
wenn ein DWDO-Bildschirm „Speicher nicht verfügbar„ meldet.
Konfiguration
Keine. Pfad und Verhalten leiten sich aus der DokuWiki-Konfiguration ab.
Paketangaben
Plugin: wkstorage
Namespace: lib/plugins/wkstorage/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2