Database beheren

Je database is aangemaakt, gekoppeld en je kunt verbinden met HeidiSQL. Nu gaan we kijken hoe je je database beheert: SQL-bestanden importeren, tabellen begrijpen, data aanpassen en backups maken. Dit zijn essentiële vaardigheden om je FiveM server soepel draaiende te houden.

SQL importeren (framework database)

Wanneer je een framework installeert zoals ESX, QBCore of VORP, zit er bijna altijd een database.sql bestand bij. Dit bestand bevat de tabelstructuren en standaard data die het framework nodig heeft. Ook veel losse resources hebben een SQL-bestand dat je moet importeren.

Zo importeer je een SQL-bestand via HeidiSQL:

Open HeidiSQL en verbind met je database
Klik in de linkerkant op je database naam zodat deze geselecteerd is
Ga naar het menu File (Bestand) en klik op "Run SQL file..." (of druk op Ctrl+Shift+F9)
Selecteer het .sql bestand dat je wilt importeren
HeidiSQL voert alle SQL commando's uit het bestand automatisch uit
Na het importeren zie je de nieuwe tabellen verschijnen in de boomstructuur aan de linkerkant (klik op F5 om te vernieuwen)

Let op: Sommige SQL-bestanden gebruiken CREATE TABLE IF NOT EXISTS, wat betekent dat ze bestaande tabellen niet overschrijven. Andere bestanden gebruiken DROP TABLE gevolgd door CREATE TABLE, wat bestaande tabellen verwijdert en opnieuw aanmaakt. Maak daarom altijd eerst een backup voordat je een SQL-bestand importeert!

Tabellen bekijken en begrijpen

Een typische FiveM database bevat tientallen tabellen. Hier is een overzicht van de meest voorkomende tabellen en wat ze bevatten:

Speler-gerelateerd:

users / players - De hoofdtabel met spelerinformatie: identifier (Steam ID, license, etc.), naam, groep (admin/user), positie op de map
player_accounts - Bankrekeningen: cash, bank, zwart geld
player_contacts - Telefooncontacten van spelers
phone_messages - Telefoonberichten tussen spelers

Eigendom-gerelateerd:

owned_vehicles - Voertuigen die spelers hebben gekocht. Bevat het model, kenteken, eigenaar en eventuele aanpassingen (opgeslagen als JSON)
owned_properties / housing - Huizen en eigendommen van spelers
trunk_inventory - Inventaris van voertuigkofferbakken

Server-gerelateerd:

items - Alle beschikbare items op de server met naam, label en gewicht
jobs - Beschikbare banen en hun rangen (grades)
job_grades - De verschillende rangen per baan met bijbehorend salaris
shops - Winkels en hun inventaris

Handmatig data aanpassen

Soms moet je handmatig iets wijzigen in de database. Bijvoorbeeld een speler admin rechten geven, een voertuig verwijderen of geld aanpassen. Wees hier heel voorzichtig mee!

Een speler admin maken (ESX):

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

Geld toevoegen aan een speler (ESX):

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

Een voertuig verwijderen:

DELETE FROM owned_vehicles WHERE plate = 'ABC123';

Gouden regels bij het aanpassen van data:

Maak altijd een backup voordat je wijzigingen maakt
Gebruik altijd een WHERE clausule bij UPDATE en DELETE, anders pas je alle rijen aan
Test je query eerst met een SELECT om te controleren welke rijen je gaat wijzigen
Voer wijzigingen uit terwijl de server uit staat, anders kunnen wijzigingen overschreven worden wanneer de server data opslaat

Voorbeeld van de veilige werkwijze: Wil je het geld van een speler aanpassen? Voer dan eerst dit uit:

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

Controleer of je de juiste speler te pakken hebt. Pas dan pas de UPDATE query uit.

Backups maken van je database

Backups zijn essentieel. Een verkeerde query, een kapotte resource of een crash kan data vernietigen. Met een backup kun je alles herstellen.

Backup maken via HeidiSQL:

Open HeidiSQL en verbind met je database
Ga naar het menu Tools en klik op "Export database as SQL"
Selecteer je database in de lijst
Kies bij "Output" voor "Single .sql file"
Kies een locatie op je computer om het bestand op te slaan
Zorg dat zowel "Create" (tabelstructuur) als "Data" (inhoud) aangevinkt staan
Klik op "Export"

Tip: Maak minstens een keer per week een backup, en altijd voordat je grote wijzigingen maakt (nieuwe resources installeren, SQL importeren, handmatige aanpassingen). Sla backups op met de datum in de bestandsnaam, bijvoorbeeld fivem_backup_2026-03-07.sql.

Backup terugzetten: Volg dezelfde stappen als bij "SQL importeren" hierboven. Open je backup .sql bestand via File > Run SQL file. Let op: dit overschrijft alle huidige data met de data uit de backup.

Veelvoorkomende problemen

Hier zijn de meest voorkomende fouten en hoe je ze oplost:

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

De host of poort is verkeerd. Controleer de gegevens in het paneel op mijn.hytalenode.nl.
Je firewall blokkeert poort 3306. Schakel tijdelijk je firewall uit om te testen.
De database server is tijdelijk niet bereikbaar. Wacht een paar minuten en probeer opnieuw.

"Access denied for user"

De gebruikersnaam of het wachtwoord klopt niet. Kopieer ze opnieuw uit het paneel.
Let op speciale tekens in het wachtwoord. Kopieer het wachtwoord in plaats van het over te typen.
Je probeert verbinding te maken met een verkeerde database. Controleer de database naam.

"Table doesn't exist"

Je bent vergeten het SQL-bestand van je framework te importeren. Importeer eerst de database.sql.
Je bent verbonden met de verkeerde database. Controleer welke database geselecteerd is.

"Duplicate entry" bij SQL import

De data bestaat al in de database. Dit gebeurt als je een SQL-bestand twee keer importeert.
Controleer of de tabellen al bestaan en of ze data bevatten voordat je opnieuw importeert.

"MySQL server has gone away"

De verbinding is verbroken, vaak door een te grote query of een timeout.
Probeer opnieuw te verbinden. Als het blijft gebeuren, splits je query op in kleinere delen.

Kom je er niet uit? Neem dan contact op met de HytaleNode support via een ticket op mijn.hytalenode.nl of via onze Discord server. We helpen je graag verder!

Database beheren