Datenbank & Migrationen
Grundsätze
- Eine Quelle der Wahrheit: alle persistenten Daten in MySQL/MariaDB.
- Migrationen sind nummerierte SQL-Skripte unter
resources/[echtwelt]/ew_database/migrations/ (z. B. 002_server_meta.sql).
- Zugriff über Dapper mit expliziten Queries — kein Lazy-Loading im Game-Loop.
Migration anlegen
- Datei
resources/[echtwelt]/ew_database/migrations/009_mein_feature.sql anlegen:
CREATE TABLE IF NOT EXISTS fishing_catch (
id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
identifier VARCHAR(64) NOT NULL,
species VARCHAR(32) NOT NULL,
weight DECIMAL(8,3) NOT NULL,
caught_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
INDEX idx_identifier (identifier)
);
- Ressource neu starten (
restart ew_database) — Migrationen laufen beim Start nummeriert durch.
- Seeds (Testdaten) gehören nach
sql/seeds/ bzw. in die Seed-Skripte der Ressource.
Zugriffs-Pattern (Server)
-- ew_database stellt Helper bereit; Queries bleiben explizit:
local rows = MySQL.query.await(
'SELECT species, weight FROM fishing_catch WHERE identifier = ? ORDER BY caught_at DESC LIMIT 10',
{ identifier })
Do & Don't
- ✅ Migrationen nummeriert und nur anfügen (niemals alte editieren).
- ✅ Indizes für Lookup-Spalten (
identifier, Timestamps).
- ❌ Keine JSON-Dateien als Datenhaltung (Drift-Gefahr — die Lektion aus Echtwelt 2).
- ❌ Kein ORM-Magic im Game-Loop.