Cours MariaDB / Connexions locales et distantes : résoudre les erreurs de connexion
Pour résoudre une erreur de connexion à MariaDB, vérifiez successivement la présence du client, le serveur et son accessibilité, l’adresse et le protocole, le compte authentifié, puis les droits sur la base. Une connexion distante exige aussi une interface d’écoute appropriée, un chemin réseau autorisé et une vérification du chiffrement ; commencez par établir une connexion TCP locale connue avant de modifier ces éléments.
Distinguer le client, le serveur et le trajet réseau
Le client est le programme qui envoie vos instructions SQL ; le serveur est le processus qui les exécute et gère les données. Installer un client ne prouve pas que le serveur fonctionne. Un pilote ODBC, utilisé par des applications pour accéder à des bases de données, ne fournit pas nécessairement l’un ou l’autre.
Contrôlez le paquet installé, le nom réel du service et le chemin de l’exécutable avec le guide d’installation de MariaDB sous Windows ou le guide d’installation sous Ubuntu. Ne changez pas les droits du compte pour réparer un exécutable absent. Une fois le serveur accessible, le cours sur les utilisateurs et les privilèges GRANT permet de distinguer les opérations autorisées.
| Symptôme | Premier contrôle | Confusion à éviter |
|---|---|---|
| Commande introuvable | Exécutable client et variable PATH | Une erreur de mot de passe |
| Connexion refusée ou délai dépassé | Serveur, adresse, port et trajet réseau | Un problème que GRANT résoudrait seul |
| Access denied | Utilisateur, origine et méthode d’authentification | Un mot de passe forcément incorrect |
| Unknown database | Serveur réellement joint et nom de la base | Un problème de table |
| Erreur de vérification TLS | Nom du serveur, autorité et certificat | Une raison de désactiver la vérification |
PATH indique au système où chercher les exécutables. Si la commande mariadb est introuvable, vérifiez le dossier du client et utilisez au besoin son chemin complet. La référence officielle du client en ligne de commande précise ses options ; le guide officiel des connexions distantes explique les conditions d’écoute et d’accès réseau.
Fixer explicitement le chemin de connexion local
Préparez un serveur d’apprentissage, une base shopcourse et le compte course_user avec les droits nécessaires sur cette base. Le client et le serveur doivent ici être sur le même ordinateur ; le port 3306 est celui de l’exemple. Adaptez-le à votre configuration et saisissez le mot de passe uniquement à l’invite demandée.
À l’invite du système, exécutez :
mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 shopcourse
Une fois connecté au client MariaDB, exécutez les instructions SQL suivantes dans cette connexion, et non dans le terminal du système :
SELECT VERSION(),@@hostname,@@port,DATABASE();
SELECT USER(),CURRENT_USER();
SHOW GRANTS;
Vérifiez la version, l’hôte du serveur, son port et la base sélectionnée. USER() renseigne l’identité de connexion, tandis que CURRENT_USER() identifie le compte effectivement utilisé pour les privilèges. Un nom d’utilisateur identique ne suffit pas à prouver que l’origine et le compte retenus sont ceux attendus.
Selon la plateforme et les options, localhost peut entraîner l’utilisation d’un socket Unix, d’un canal nommé ou de TCP. TCP est le protocole réseau utilisé dans cet exercice ; l’association de --protocol=tcp et 127.0.0.1 rend ce choix explicite. Une connexion à un socket qui fonctionne ne valide pas à elle seule le chemin TCP.
Tester une vraie table après l’authentification
Une authentification réussie ne prouve pas que le compte peut accéder à la base et aux tables voulues. Contrôlez d’abord que le nom products_44_lab n’est pas utilisé. S’il existe, examinez sa définition et ses données, sauvegardez ce qui doit être conservé et choisissez un autre nom dans tout l’exercice plutôt que d’écraser la table.
Enregistrez ce bloc complet en UTF-8, par exemple dans C:/mariadb-lab/c44-connexion.sql. Dans le client MariaDB déjà connecté avec le compte d’apprentissage, lancez SOURCE C:/mariadb-lab/c44-connexion.sql; en adaptant le chemin réel. Le compte doit pouvoir créer et remplir cette table.
USE shopcourse;
CREATE TABLE products_44_lab (
product_id INT NOT NULL AUTO_INCREMENT,
product_name VARCHAR(100) NOT NULL,
category VARCHAR(30) NOT NULL,
price DECIMAL(10,2) NOT NULL,
stock INT NOT NULL DEFAULT 0,
note VARCHAR(100) NULL DEFAULT NULL,
PRIMARY KEY (product_id),
CONSTRAINT ck_p44_price CHECK (price >= 0),
CONSTRAINT ck_p44_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_44_lab (product_id,product_name,category,price,stock,note) VALUES (1, '노트', '문구', 3500.00, 20, NULL),
(2, '볼펜', '문구', 1500.00, 0, ''),
(3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
(4, '스탠드', '생활', 25000.00, 5, NULL),
(5, '파일', '문구', 1500.00, 50, ''),
(6, '케이블', '전자', 8000.00, 0, '호환 확인');
Les chaînes coréennes sont conservées pour vérifier le même jeu de données en UTF-8. Les identifiants 1 à 6 représentent un carnet, un stylo, une tasse, une lampe, un dossier et un câble ; les catégories correspondent à la papeterie, aux articles ménagers et à l’électronique. Conservez les littéraux tels quels et comparez les résultats à partir des identifiants.
SELECT COUNT(*) FROM products_44_lab;
Le résultat attendu est 6. Un simple SELECT 1 ne prouve pas l’accès à toutes les tables nécessaires ; testez les opérations réellement requises avec le compte concerné. Un refus lors de CREATE TABLE ou INSERT doit conduire à examiner le besoin et les droits appropriés, pas à accorder systématiquement tous les privilèges.
Pour conserver un diagnostic utile, notez le code d’erreur, l’étape, le nom logique de la cible et un message débarrassé des secrets. Les mots de passe et d’éventuelles informations d’authentification de SHOW GRANTS ne doivent pas apparaître dans les captures ou les journaux partagés.
Limiter l’écoute distante au trajet nécessaire
Avec l’administrateur, identifiez l’adresse privée réelle du serveur, le port, l’origine des clients autorisés et la politique TLS. TLS, pour Transport Layer Security, protège la connexion et permet de vérifier l’identité du serveur lorsqu’il est correctement configuré. L’ouverture d’un port ne remplace pas les droits du compte ni cette vérification.
Sur Ubuntu, un paquet peut utiliser /etc/mysql/mariadb.conf.d/50-server.cnf, mais ce chemin n’est pas universel. Identifiez les fichiers effectivement lus par le serveur, sauvegardez le fichier concerné et relevez les valeurs d’origine avant toute modification. Dans la section serveur appropriée, l’extrait suivant illustre une écoute sur une interface privée déterminée :
[mariadbd]
bind-address = 10.0.0.10
port = 3306
10.0.0.10 est une adresse d’exemple ; elle doit être remplacée par une adresse réellement affectée à une interface du serveur. Si skip-networking est activé, le serveur n’écoute pas en TCP : ce point doit être examiné avec la politique voulue, sans modifier aveuglément un environnement existant.
Autorisez uniquement les origines nécessaires dans les règles réseau et dans les comptes. L’adresse Host d’un compte décrit l’origine du client vue par le serveur ; elle n’est pas automatiquement correcte parce que des paquets arrivent au port. Préparez l’interruption éventuelle du service, la méthode de redémarrage propre à l’installation et le retour au fichier sauvegardé. Après application, contrôlez l’écoute réelle et refaites le test depuis l’origine prévue.
Vérifier le certificat distant et le compte retenu
La commande suivante suppose un serveur réel dont le nom se résout et un fichier de certificat d’autorité de confiance. Remplacez db.example.internal, le chemin du fichier et le port selon votre environnement. Le nom de serveur utilisé doit correspondre au certificat. CA désigne ici l’autorité de certification qui permet au client de vérifier la chaîne de confiance.
mariadb --protocol=tcp --host=db.example.internal --port=3306 --user=app_user --password --ssl --ssl-verify-server-cert --ssl-ca=C:/mariadb-lab/ca.pem
Une réussite locale ne valide ni le réseau distant ni TLS. Dans la connexion distante, reprenez les contrôles d’identité et de serveur de la section locale, puis testez les opérations autorisées sur la base attendue avec ce compte. Ne copiez pas le mot de passe dans la ligne de commande.
Un tunnel SSH ou un VPN approuvé peut constituer un autre trajet. Vérifiez toutefois l’origine réellement visible par MariaDB et le compte qu’elle sélectionne. Élargir l’écoute à toutes les interfaces, utiliser une origine de compte générique ou désactiver le contrôle du certificat ne doit pas devenir une réparation habituelle des erreurs de connexion.
Noter l’étape en échec et revenir aux réglages précédents
Pour une cible injoignable, contrôlez la résolution DNS du nom, l’adresse du client, l’interface d’écoute, le port et le pare-feu. Une fois la cible joignable, examinez la correspondance utilisateur–Host, le mécanisme d’authentification et les identifiants. Une base inconnue ou un refus sur une table se situe à une étape ultérieure et appelle un contrôle de cible ou de droits.
Notez chaque modification avec sa valeur précédente et les redémarrages réalisés. Si une modification d’écoute n’a pas le résultat voulu, restaurez le fichier sauvegardé et les seules règles réseau modifiées pour ce test, puis appliquez et vérifiez le retour à la politique antérieure. Ne retirez pas de règles partagées sans connaître leur rôle.
À la fin de l’exercice, confirmez la base, examinez le contenu et conservez les données utiles avant de supprimer uniquement la table jetable créée ici :
DROP TABLE shopcourse.products_44_lab;
DROP TABLE supprime la définition et les lignes ; un ROLLBACK ordinaire ne permet pas de revenir sur ce nettoyage. Pour répéter le test, vérifiez que le nom est disponible et réexécutez le bloc de préparation. Les autres tables, comptes et services doivent rester inchangés.




