MySQL & MariaDB

QoreDB se connecte à MySQL et MariaDB via un seul pilote. Les deux moteurs parlent le même protocole filaire, le flux de connexion, le format du DSN et les options SSL sont donc identiques.

Connexion rapide

Le moyen le plus rapide est de coller un DSN. QoreDB reconnaît le schéma mysql://.

mysql://UTILISATEUR:MOTDEPASSE@HOTE:3306/BASEDEDONNEES
mysql://UTILISATEUR:MOTDEPASSE@HOTE:3306/BASEDEDONNEES?ssl-mode=REQUIRED

Ouvrez Nouvelle Connexion (New Connection), choisissez MySQL/MariaDB, collez l'URL, cliquez sur Tester la connexion (Test connection), puis sur Enregistrer (Save).

Champs de connexion

Si vous préférez le formulaire, remplissez directement ces champs :

La section Tunnel SSH (SSH tunnel) est disponible si votre base de données se trouve derrière un bastion. Voir Tunneling SSH.

Modes SSL / TLS

MySQL a sa propre dénomination pour les modes SSL ; le comportement sous-jacent correspond approximativement aux modes PostgreSQL équivalents.

Pour le trafic de production sur l'Internet public, verify-identity est la valeur par défaut la plus sûre. required est acceptable sur un réseau privé de confiance.

Vous pouvez transmettre le mode soit via le formulaire (liste déroulante du mode SSL) soit en tant que paramètre ?ssl-mode=… sur l'URL.

MySQL vs MariaDB

Le pilote est le même. Quelques différences pratiques à connaître :

• Plugins d'authentification : MySQL 8 utilise par défaut caching_sha2_password, MariaDB utilise par défaut mysql_native_password. QoreDB gère les deux, mais si vos outils clients sont plus anciens et que vous voyez des erreurs d'authentification sur MySQL 8, vous devrez peut-être changer le plugin d'authentification de l'utilisateur côté serveur (ALTER USER … IDENTIFIED WITH mysql_native_password BY …) ou effectuer une mise à niveau.
• Type JSON : les deux moteurs ont un type JSON mais avec des fonctions légèrement différentes (JSON_EXTRACT vs JSON_VALUE de MariaDB). Les requêtes qui reposent sur ces fonctions ne sont pas portables entre les deux.
• Jeu de caractères (Character set) : MySQL 8 utilise par défaut utf8mb4. MariaDB jusqu'à 10.5 utilise par défaut utf8mb3 ; à partir de 10.6+ également utf8mb4. Si vous voyez des caractères illisibles (mojibake) ou des erreurs "Incorrect string value", vérifiez le jeu de caractères de la connexion et le classement (collation) de la colonne.

Fournisseurs compatibles MySQL

Les services suivants utilisent le protocole filaire MySQL et se connectent via ce pilote :

• PlanetScale : collez la chaîne de connexion de votre tableau de bord. PlanetScale applique le protocole TLS, utilisez donc ?ssl-mode=REQUIRED (ou supérieur).
• AWS RDS pour MySQL/MariaDB : DSN standard mysql://. Les instances RDS accessibles depuis l'extérieur du VPC doivent avoir un accès public activé ou un tunnel. SSL est recommandé.
• Aiven, DigitalOcean Managed MySQL, Google Cloud SQL : DSN MySQL standard. Tous exigent TLS par défaut.

Navigation dans les schémas

Une fois connecté, développez la connexion dans la barre latérale :

Connexion → Base de données → Tables / Vues / Routines / Déclencheurs

MySQL n'a pas de schémas au sens de PostgreSQL ; dans MySQL, "schéma" et "base de données" sont synonymes. Choisissez la base de données dans laquelle vous souhaitez travailler à partir de l'arborescence.

Problèmes courants

Où aller ensuite

• Tunneling SSH pour les bases de données derrière un bastion
• Coffre-fort et profils pour organiser de nombreuses connexions
• Interrogation : éditeur et autocomplétion pour commencer à écrire du SQL