Verbinden met HeidiSQL

Soms wil je rechtstreeks in je database kijken: spelerdata opzoeken, tabellen bekijken of handmatig iets aanpassen. Daarvoor gebruik je een database client. HeidiSQL is een gratis en populaire tool voor Windows waarmee je eenvoudig je MySQL database kunt beheren via een overzichtelijke interface.

HeidiSQL downloaden en installeren

Ga naar de officiële website: www.heidisql.com/download.php
Klik op "Installer" om het installatiebestand te downloaden
Voer het gedownloade bestand uit en volg de installatiestappen
Laat alle standaard instellingen staan en klik steeds op "Next" tot de installatie klaar is
Start HeidiSQL op na de installatie

Alternatief voor Mac/Linux: HeidiSQL is alleen beschikbaar voor Windows. Gebruik je een Mac of Linux? Dan kun je DBeaver gebruiken (dbeaver.io), een gratis alternatief dat op alle besturingssystemen werkt. De stappen zijn vergelijkbaar.

Nieuwe sessie aanmaken

Wanneer je HeidiSQL voor het eerst opent, zie je het Session Manager scherm. Hier maak je een nieuwe verbinding aan:

Klik linksonder op "New" (Nieuw) om een nieuwe sessie aan te maken
Geef de sessie een herkenbare naam, bijvoorbeeld "HytaleNode FiveM"
Vul de volgende gegevens in die je uit het HytaleNode paneel hebt gekregen:

Network type: MySQL (TCP/IP) - dit staat standaard al goed
Hostname / IP: Vul hier de host in uit het paneel (bijvoorbeeld db.hytalenode.nl)
User: Vul hier de gebruikersnaam in (bijvoorbeeld u1_abc123xyz)
Password: Vul hier het wachtwoord in
Port: Vul hier de poort in (standaard 3306)
Database: Dit veld mag je leeg laten, of vul de database naam in

Verbinding maken

Klik op "Open" om verbinding te maken met je database. Als alles goed is ingevuld, opent HeidiSQL de database en zie je aan de linkerkant een boomstructuur met je database en alle tabellen.

Lukt het niet? Controleer dan het volgende:

Heb je alle gegevens correct overgenomen uit het paneel?
Staat er een firewall actief op je computer die poort 3306 blokkeert?
Is de host correct? Kopieer deze rechtstreeks uit het paneel.

Tabellen bekijken

Na het verbinden zie je aan de linkerkant je database. Klik op de database naam om deze uit te klappen. Je ziet nu een lijst met alle tabellen. Bij een FiveM server met ESX of QBCore zie je bijvoorbeeld tabellen zoals:

users of players - Spelergegevens (naam, identifier, groep)
owned_vehicles - Voertuigen die spelers bezitten
items - Beschikbare items in de server
player_accounts - Bankrekeningen en geld van spelers
jobs - Beschikbare banen

Klik op een tabel om de inhoud te bekijken. In het "Data" tabblad zie je alle rijen (records) die in de tabel staan. In het "Table" tabblad kun je de structuur van de tabel bekijken: welke kolommen er zijn en welk type data ze bevatten.

Basis queries uitvoeren

HeidiSQL heeft een ingebouwde query editor waarmee je SQL commando's kunt uitvoeren. Klik op het tabblad "Query" (of druk op Ctrl+T) om een nieuw query venster te openen.

Hier zijn een paar handige basis queries die je kunt proberen:

Alle spelers bekijken:

SELECT * FROM users;

Een specifieke speler opzoeken op naam:

SELECT * FROM users WHERE firstname = 'Jan';

Alle voertuigen van een speler bekijken:

SELECT * FROM owned_vehicles WHERE owner = 'steam:xxxxxxxxxxxxxxx';

Het aantal spelers in de database tellen:

SELECT COUNT(*) FROM users;

Typ je query in het tekstvak en klik op de blauwe play-knop (of druk op F9) om de query uit te voeren. Het resultaat verschijnt onderaan het scherm.

Tip: Begin altijd met SELECT queries om data te bekijken. Voer pas UPDATE of DELETE queries uit als je zeker weet wat je doet. Een verkeerde wijziging kan je server kapot maken!

Verbinden met HeidiSQL