Cours MariaDB / Installer MariaDB sous Windows et démarrer le serveur

Sur Windows, MariaDB Server peut être installé avec un paquet MSI et fonctionner comme un service Windows. Pour disposer d’un environnement d’exercice utilisable, relevez le nom du service, le port et le mot de passe administrateur, puis vérifiez une véritable connexion et le résultat d’une requête SQL.

Vérifier le poste avant l’installation

Ce guide concerne une nouvelle installation locale d’apprentissage sur Windows 11 64 bits. L’installation du MSI et la gestion des services peuvent demander des droits administrateur. Si MySQL ou MariaDB est déjà installé, commencez par distinguer une mise à niveau de l’instance existante de la création d’une instance indépendante. Le rôle du serveur et du client MariaDB explique pourquoi l’installation du client seul ne suffit pas.

Dans PowerShell, consultez d’abord les services et le port habituel du serveur. Ces deux commandes lisent l’état du poste : elles ne démarrent ni n’arrêtent de service.

Get-Service | Where-Object { $_.Name -match 'MariaDB|MySQL' }
Get-NetTCPConnection -State Listen -LocalPort 3306 -ErrorAction SilentlyContinue

Sur un poste sans serveur, l’absence de résultat est normale. Pour un service détecté, relevez la propriété Name : son nom technique peut différer du nom affiché. La seconde commande recherche une écoute TCP sur le port 3306 ; un résultat indique que ce port est déjà occupé, sans prouver à lui seul quel service l’utilise.

Ne stoppez pas une instance inconnue et ne réutilisez pas son répertoire de données. Une nouvelle instance indépendante doit posséder son propre nom de service, son propre répertoire de données et, si nécessaire, un autre port. Si vous retenez par exemple 3307, remplacez 3306 par 3307 dans toutes les commandes de connexion de cette page.

Télécharger le MSI et choisir les composants

  1. Ouvrez la page officielle de téléchargement de MariaDB Server. Sélectionnez une version stable prise en charge, Windows, l’architecture x64 et le paquet MSI. Une version de prévisualisation n’est pas le point de départ de cet exercice.
  2. Lancez le MSI téléchargé. Lisez la licence, puis poursuivez vers l’étape Custom Setup. Vérifiez que le serveur, les outils clients et le composant Database instance sont sélectionnés. Un outil graphique tel que HeidiSQL est facultatif pour ces exercices en ligne de commande.
  3. Relevez le dossier d’installation et le répertoire de données. Les commandes ci-dessous utilisent C:\Program Files\MariaDB 12.3\ comme exemple de chemin ; utilisez le dossier réellement installé si le nom de version ou l’emplacement diffère.

Les intitulés et la disposition de l’assistant peuvent varier selon la version. Le guide officiel d’installation MSI sous Windows décrit les options de l’instance. Si l’assistant propose de mettre à niveau une installation existante, ne choisissez pas cette opération pour créer simplement un nouvel environnement d’apprentissage.

Régler le compte administrateur, le service et le réseau

Option Choix pour l’exercice local
Mot de passe root Choisissez un mot de passe robuste et conservez-le en lieu sûr. root est ici l’administrateur de la base.
Accès distant de root Laissez cette possibilité désactivée pour l’exercice local.
Compte anonyme Laissez sa création désactivée.
Service Windows Choisissez l’installation comme service et notez son nom exact.
Réseau TCP Activez TCP/IP pour les commandes de cette page. Utilisez 3306 s’il est libre, sinon notez le port choisi.
Option UTF-8 Elle ne remplace pas le choix explicite d’utf8mb4 lors de la création des bases.

Le mot de passe de root MariaDB n’est pas le mot de passe de votre session Windows. Le cours utilisera ensuite un compte limité à la base d’exercice. Si une option UTF-8 est proposée, ne supposez pas que son libellé garantit automatiquement tous les réglages utf8mb4 attendus pour les bases et les connexions.

Une connexion locale à 127.0.0.1 ne nécessite pas d’ouvrir le port du serveur aux réseaux extérieurs. Ne créez donc pas une règle d’accès externe pour résoudre un problème purement local. Terminez l’installation et relevez tout message d’erreur ; la fermeture de l’assistant ne dispense pas de contrôler le service et la connexion.

Démarrer le service et vérifier une connexion administrateur

Si le nom technique du service est MariaDB, les commandes PowerShell suivantes permettent de lire son état, de le démarrer si nécessaire, puis de relire son état. Remplacez le nom si vous en avez choisi un autre. Pour démarrer le service, ouvrez si nécessaire PowerShell avec Exécuter en tant qu’administrateur. S’il est déjà en cours d’exécution, ne le redémarrez pas sans raison : vérifiez simplement son état.

Get-Service -Name MariaDB
Start-Service -Name MariaDB
Get-Service -Name MariaDB

L’état final attendu est Running. Ce contrôle confirme le fonctionnement du service, mais pas encore l’authentification d’un utilisateur. Le raccourci d’invite de commandes MariaDB fourni par l’installation peut ajouter le dossier bin au PATH. Dans un PowerShell ordinaire, un chemin complet évite de dépendre de ce réglage :

& "C:\Program Files\MariaDB 12.3\bin\mariadb.exe" --protocol=tcp --host=127.0.0.1 --port=3306 --user=root --password --default-character-set=utf8mb4

L’opérateur PowerShell & lance le programme dont le chemin est placé entre guillemets. Remplacez le chemin et le port par vos valeurs. L’option --password sans valeur demande le mot de passe de manière interactive ; ne l’ajoutez pas en clair à la commande. --protocol=tcp impose la connexion TCP à l’adresse locale choisie et --default-character-set=utf8mb4 règle le jeu de caractères du client.

Une fois l’invite MariaDB obtenue, exécutez ces instructions dans le client, et non directement dans PowerShell :

SELECT VERSION() AS server_version;
SELECT 1 + 1 AS result;

Vous devez obtenir la version du serveur connecté, puis une valeur 2 sous l’en-tête result. La version retournée peut différer du numéro utilisé dans le chemin d’exemple. Ouvrir le programme client sans réussir la connexion ne suffit pas à valider l’installation.

Créer un compte réservé à la base d’exercice

Gardez root pour l’administration initiale et utilisez ensuite course_user pour les exercices SQL. Dans la connexion administrateur, recherchez d’abord les comptes de ce nom :

SELECT User, Host FROM mysql.user WHERE User = 'course_user';

Sur une nouvelle instance, aucun compte correspondant n’est attendu. Si une ligne existe déjà, inspectez son hôte et sa fonction ; ne supprimez pas le compte et ne remplacez pas son mot de passe à l’aveugle. Pour créer un nouveau compte d’exercice, remplacez CHANGE_THIS_TO_YOUR_OWN_PASSWORD par votre propre mot de passe robuste, puis exécutez :

CREATE USER 'course_user'@'127.0.0.1'
  IDENTIFIED BY 'CHANGE_THIS_TO_YOUR_OWN_PASSWORD';

GRANT ALL PRIVILEGES ON shopcourse.*
  TO 'course_user'@'127.0.0.1';

SHOW GRANTS FOR 'course_user'@'127.0.0.1';

Le nom complet d’un compte associe un utilisateur et un hôte. Ici, les commandes emploient volontairement TCP et 127.0.0.1, comme le compte autorisé. Ne remplacez pas cet hôte par % pour contourner un refus d’accès : cela étendrait les hôtes autorisés.

Le périmètre shopcourse.* couvre la base d’exercice et ses objets. Il autorise les opérations du cours, y compris la création de cette base, sans accorder de privilèges globaux ni le droit de transmettre des privilèges à d’autres comptes. Il est possible d’accorder ce périmètre avant la création de la base. Dans une application en production, les droits seraient normalement plus restreints et adaptés au travail réellement effectué. Les références CREATE USER et GRANT détaillent ces règles.

Dans la sortie de SHOW GRANTS, vérifiez l’identité du compte et l’autorisation sur shopcourse.*. Une ligne USAGE ON *.* peut également apparaître : USAGE ne donne pas accès à toutes les bases. Il ne faut pas la confondre avec un octroi global de privilèges.

Quittez le client avec EXIT;, puis reconnectez-vous depuis le terminal :

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error

Cette forme courte suppose que mariadb est accessible dans le PATH. Sinon, utilisez le même chemin complet et l’opérateur & que plus haut, en conservant ces options et en remplaçant --user=root par --user=course_user. Saisissez le mot de passe du nouveau compte, pas celui de root. Dans la nouvelle connexion, contrôlez le compte qui fournit les privilèges :

SELECT CURRENT_USER() AS privilege_account;

La valeur attendue est course_user@127.0.0.1. Si elle diffère, vérifiez les comptes hôtes et les paramètres de connexion avant de continuer. Les instructions CREATE USER et GRANT appliquent leurs changements sans demander un FLUSH PRIVILEGES manuel dans cette procédure.

Diagnostiquer les erreurs sans perdre les données

Symptôme Vérification à effectuer
Le service ne démarre pas Contrôlez son nom exact, un conflit de port et le journal d’erreurs de l’instance. Préservez le répertoire de données.
Commande mariadb introuvable Utilisez le chemin complet de l’exécutable réellement installé ou l’invite de commandes de l’installation.
Connexion impossible Vérifiez que le bon service est démarré et que l’adresse, le protocole et le port de la commande correspondent à cette instance.
Message Access denied Vérifiez le mot de passe et l’hôte du compte. Un échec d’authentification n’est pas la même chose qu’un serveur arrêté.

Avant toute modification de my.ini, enregistrez une copie du fichier et son chemin exact. Ne changez qu’un réglage à la fois, redémarrez uniquement l’instance concernée, puis contrôlez le résultat. Si le changement empêche le démarrage, rétablissez le fichier sauvegardé et vérifiez à nouveau le service.

Arrêter un service, désinstaller un programme et supprimer des fichiers de base de données sont des opérations distinctes. La suppression des données n’est pas une méthode normale pour corriger une connexion. L’installation est prête pour les exercices lorsque le service attendu est Running, la connexion administrateur renvoie une version et le calcul 2, et la connexion d’exercice identifie bien course_user@127.0.0.1.