Datenbank verwalten

Deine Datenbank ist erstellt, verknüpft und du kannst dich mit HeidiSQL verbinden. Jetzt schauen wir, wie du deine Datenbank verwaltest: SQL-Dateien importieren, Tabellen verstehen, Daten anpassen und Backups erstellen. Das sind wichtige Fähigkeiten, damit dein FiveM-Server reibungslos läuft.

SQL importieren (Framework-Datenbank)

Wenn du ein Framework wie ESX, QBCore oder VORP installierst, ist fast immer eine database.sql-Datei dabei. Diese Datei enthält die Tabellenstrukturen und Standarddaten, die das Framework benötigt. Auch viele einzelne Resources haben eine SQL-Datei, die du importieren musst.

So importierst du eine SQL-Datei über HeidiSQL:

Öffne HeidiSQL und verbinde dich mit deiner Datenbank
Klicke links auf deinen Datenbanknamen, damit er ausgewählt ist
Gehe im Menü zu File (Datei) und klicke auf "Run SQL file..." (oder drücke Ctrl+Shift+F9)
Wähle die .sql-Datei aus, die du importieren möchtest
HeidiSQL führt alle SQL-Befehle aus der Datei automatisch aus
Nach dem Import siehst du die neuen Tabellen in der Baumstruktur links (klicke auf F5, um zu aktualisieren)

Achtung: Manche SQL-Dateien verwenden CREATE TABLE IF NOT EXISTS, was bedeutet, dass bestehende Tabellen nicht überschrieben werden. Andere Dateien verwenden DROP TABLE gefolgt von CREATE TABLE, wodurch bestehende Tabellen gelöscht und neu erstellt werden. Erstelle deshalb immer zuerst ein Backup, bevor du eine SQL-Datei importierst!

Tabellen ansehen und verstehen

Eine typische FiveM-Datenbank enthält Dutzende Tabellen. Hier ist eine Übersicht der häufigsten Tabellen und ihres Inhalts:

Spielerbezogen:

users / players – Die Haupttabelle mit Spielerinformationen: Identifier (Steam ID, License usw.), Name, Gruppe (Admin/User), Position auf der Karte
player_accounts – Bankkonten: Bargeld, Bank, Schwarzgeld
player_contacts – Telefonkontakte der Spieler
phone_messages – Telefonnachrichten zwischen Spielern

Eigentumsbezogen:

owned_vehicles – Fahrzeuge, die Spieler gekauft haben. Enthält Modell, Kennzeichen, Besitzer und eventuelle Anpassungen (als JSON gespeichert)
owned_properties / housing – Häuser und Immobilien der Spieler
trunk_inventory – Inventar von Fahrzeugkofferräumen

Serverbezogen:

items – Alle verfügbaren Items auf dem Server mit Name, Label und Gewicht
jobs – Verfügbare Jobs und ihre Ränge (Grades)
job_grades – Die verschiedenen Ränge pro Job mit zugehörigem Gehalt
shops – Shops und deren Inventar

Daten manuell anpassen

Manchmal musst du etwas manuell in der Datenbank ändern. Zum Beispiel einem Spieler Admin-Rechte geben, ein Fahrzeug entfernen oder Geld anpassen. Sei dabei sehr vorsichtig!

Einen Spieler zum Admin machen (ESX):

UPDATE users SET \`group\` = 'admin' WHERE identifier = 'steam:xxxxxxxxxxxxxxx';

Einem Spieler Geld hinzufügen (ESX):

UPDATE player_accounts SET money = money + 50000 WHERE identifier = 'steam:xxxxxxxxxxxxxxx' AND name = 'bank';

Ein Fahrzeug entfernen:

DELETE FROM owned_vehicles WHERE plate = 'ABC123';

Goldene Regeln beim Anpassen von Daten:

Erstelle immer ein Backup, bevor du Änderungen vornimmst
Verwende immer eine WHERE-Klausel bei UPDATE und DELETE, sonst änderst du alle Zeilen
Teste deine Query zuerst mit einem SELECT, um zu prüfen, welche Zeilen du ändern wirst
Führe Änderungen aus, während der Server ausgeschaltet ist, sonst können Änderungen überschrieben werden, wenn der Server Daten speichert

Beispiel für das sichere Vorgehen: Willst du das Geld eines Spielers anpassen? Führe dann zuerst Folgendes aus:

SELECT * FROM player_accounts WHERE identifier = 'steam:xxxxxxxxxxxxxxx';

Prüfe, ob du den richtigen Spieler erwischt hast. Führe erst dann die UPDATE-Query aus.

Backups deiner Datenbank erstellen

Backups sind essentiell. Eine falsche Query, eine defekte Resource oder ein Crash kann Daten zerstören. Mit einem Backup kannst du alles wiederherstellen.

Backup über HeidiSQL erstellen:

Öffne HeidiSQL und verbinde dich mit deiner Datenbank
Gehe im Menü zu Tools und klicke auf "Export database as SQL"
Wähle deine Datenbank aus der Liste
Wähle bei "Output" "Single .sql file"
Wähle einen Speicherort auf deinem Computer für die Datei
Stelle sicher, dass sowohl "Create" (Tabellenstruktur) als auch "Data" (Inhalt) aktiviert sind
Klicke auf "Export"

Tipp: Erstelle mindestens einmal pro Woche ein Backup, und immer bevor du große Änderungen vornimmst (neue Resources installieren, SQL importieren, manuelle Anpassungen). Speichere Backups mit dem Datum im Dateinamen, zum Beispiel fivem_backup_2026-03-07.sql.

Backup wiederherstellen: Folge denselben Schritten wie beim "SQL importieren" oben. Öffne deine Backup-.sql-Datei über File > Run SQL file. Achtung: Dies überschreibt alle aktuellen Daten mit den Daten aus dem Backup.

Häufige Probleme

Hier sind die häufigsten Fehler und wie du sie behebst:

"Connection refused" / "Can't connect to MySQL server"

Host oder Port ist falsch. Prüfe die Daten im Panel auf mijn.hytalenode.nl.
Deine Firewall blockiert Port 3306. Deaktiviere deine Firewall vorübergehend zum Testen.
Der Datenbankserver ist vorübergehend nicht erreichbar. Warte ein paar Minuten und versuche es erneut.

"Access denied for user"

Benutzername oder Passwort ist falsch. Kopiere sie erneut aus dem Panel.
Achte auf Sonderzeichen im Passwort. Kopiere das Passwort, anstatt es abzutippen.
Du versuchst, dich mit der falschen Datenbank zu verbinden. Prüfe den Datenbanknamen.

"Table doesn't exist"

Du hast vergessen, die SQL-Datei deines Frameworks zu importieren. Importiere zuerst die database.sql.
Du bist mit der falschen Datenbank verbunden. Prüfe, welche Datenbank ausgewählt ist.

"Duplicate entry" beim SQL-Import

Die Daten existieren bereits in der Datenbank. Das passiert, wenn du eine SQL-Datei zweimal importierst.
Prüfe, ob die Tabellen bereits existieren und Daten enthalten, bevor du erneut importierst.

"MySQL server has gone away"

Die Verbindung wurde getrennt, oft durch eine zu große Query oder ein Timeout.
Versuche erneut, dich zu verbinden. Wenn es weiterhin passiert, teile deine Query in kleinere Teile auf.

Kommst du nicht weiter? Dann kontaktiere den HytaleNode-Support über ein Ticket auf mijn.hytalenode.nl oder über unseren Discord-Server. Wir helfen dir gerne weiter!

Datenbank verwalten