Zum Inhalt springen

Datenbank & Migrationen

Last updated 21.11.2026 17:53:42 by Administrator

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

  1. 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)
);
  1. Ressource neu starten (restart ew_database) — Migrationen laufen beim Start nummeriert durch.
  2. 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.