Datenbankaufbau
ZeitenSchleife verwendet eine MySQL-/MariaDB-Datenbank für den Kern. Jedes Plugin hat einen eigenen SQL-Namespace mit einer separat zugewiesenen MySQL-/MariaDB-Datenbank. Externe SQL-Adapter für Datenquellen ändern das Schema dieser Verbindungen nicht.
Entity, Attribute, Value
In einer EAV-Tabelle verweist die Entity-ID auf den Datensatz, das Attribut auf eine Eigenschaft und der Wert enthält deren Inhalt. Ein Bestandsartikel mit der ID 17 und zwei Nährwertfeldern hat zwei Zeilen in asset_values. Ein neues Feld benötigt keine zusätzliche Spalte.
| Datenbank | Entitäten und Beziehungen | EAV-Tabelle |
|---|---|---|
| Kern | users, sessions, rbac_*, settings, notifications, user_dashboards, user_workspaces, user_avatars, app_files, audit_logs, event_logs, imap_*, ldap_identities, authentik_identities | user_properties(user_id, attribute, value) für eigene Eigenschaften. Der zusammengesetzte Schlüssel ordnet einen Wert pro Eigenschaft und Konto zu. |
| Bestand | asset_types, asset_groups, asset_field_types, asset_fields, asset_items, asset_images, asset_hierarchy, asset_hierarchy_state | asset_values(item_id, field_id, value_json). Die Felddefinition legt den Typ fest. Der Wert einer Auswahl kann eine Liste sein. |
| Kalender | appointments, calendar_sources, calendar_imports, calendar_preferences, calendar_mail_rules | calendar_appointment_values(appointment_id, attribute, value) für Zusatzangaben zu lokalen Terminen. Beginn und Ende liegen indexierbar am Termin. |
| Abläufe | workflow_definitions, workflow_runs, workflow_history, workflow_subscriptions | workflow_definition_values(definition_id, step_index, value_json). Die Position bezeichnet den Baustein der Vorlage. Gestartete Vorgänge behalten einen JSON-Schnappschuss, damit sie bei späteren Änderungen der Vorlage gleich weiterlaufen. workflow_display_values speichert showMiniMap und cardColumns für jedes Konto. |
| Pläne | plans, plan_tasks | Eigene Listen und Aufgaben mit Fälligkeitsdatum und Status in festen Spalten. plan_task_values(task_id, attribute, value) speichert Zusatzangaben wie die Beschreibung einer aus dem Portal übernommenen Aufgabe. |
| Portal | portal_reports, portal_types, portal_settings, portal_form_settings, portal_guest_appointments, portal_calendar_publications | portal_form_settings.ticket_types enthält die Formulare des Portal-Designers als JSON. portal_report_values(report_id, attribute, value) enthält die Momentaufnahme der eingereichten Felder, die Zuordnung zum Ziel-Plugin und bei öffentlichen Meldungen den Hash des Statuslinks. |
Stabile Daten wie Anmeldenamen, Sitzungsablauf, Berechtigungsbeziehungen, Terminzeiten und Vorgangsstatus behalten feste Spalten. So kann die Datenbank eindeutige Werte und Fremdschlüssel durchsetzen und häufige Abfragen gezielt indizieren. Administratoren können in users zusätzliche Textspalten anlegen und diese bei einem LDAP-Import als Ziel wählen. Für Änderungen am Schema braucht der Datenbankbenutzer das Recht ALTER. Bestehende Werte in user_properties bleiben in der Benutzerverwaltung verfügbar.
Die Dateiverwaltung speichert bis zu zwölf Tags je Datei in app_files.tags. Der Dateiname auf dem Server bleibt eine zufällige Kennung. Das Feld folder_id stellt sicher, dass ältere Dateien über ihren bisherigen Speicherpfad erreichbar bleiben.
Anlegen, aktualisieren und sichern
- Sichere die Kern- und Plugin-Datenbanken sowie das Datenverzeichnis des Containers.
- Öffne „Administration → Datenbank“. Trage Server, Port, Datenbank und Zugangsdaten ein. Aktiviere für eine neue Datenbank „Datenbank bei Bedarf anlegen“. „Speichern und verbinden“ richtet die Kerntabellen ein.
- Öffne „Administration → Plugins“ und klappe die Einstellungen des Plugins auf. Gib eine separate MySQL-/MariaDB-Datenbank an. Aktiviere bei Bedarf dieselbe Option zum Anlegen. Speichere die Verbindung und wähle beim gestarteten Plugin „Tabellen anlegen“.
- Repariere bekannte Schemafehler im Bereich „Tabellenpflege“. Für den Kern heißt die Schaltfläche „Datenbank reparieren“. Bei einem nicht betriebsbereiten Kern erreichst du die gespeicherte Verbindung über die Anmeldung als lokaler Administrator. Für ein Plugin wählst du „Tabellen reparieren“.
Zum Anlegen braucht das Datenbankkonto CREATE für das Zielschema. Für die Schema-Pflege braucht es abhängig vom fehlenden Teil auch ALTER. Verlorene Daten stellst du aus einem Backup wieder her. Bei Bestand, Kalender und Abläufen übernehmen die Migrationsfunktionen vorhandene Werte in die vorgesehenen EAV-Tabellen.
Bei bestehenden Abläufe-Datenbanken gelten die Standardwerte für die Kartendarstellung bis zur ersten Änderung. Beim Speichern wird workflow_display_values bei Bedarf angelegt. Die Tabellenreparatur kann sie vorab ergänzen.
Die Kerndatenbank speichert Sicherungen der Rollen, Gruppen, Berechtigungen und Zuweisungen in rbac_snapshots. Die Wiederherstellung speichert zuerst den aktuellen Stand und wendet die Regeln in derselben Transaktion an. RBAC-Schnappschüsse verwalten
Der lokale Administrator bleibt beim Ausfall der Datenbank verfügbar. Der Lizenzimport speichert geprüfte Lizenzdaten bei verbundener Kerndatenbank in vaultify_license_import. Bei einem ZIP-Import wird der öffentliche Schlüssel im selben Datenbankeintrag gespeichert. Die Installations-ID und Lizenzdaten aus einem lokalen SQL-Import liegen im Datenverzeichnis. Dort sucht ZeitenSchleife standardmäßig auch den dateibasierten Prüfschlüssel.