Comment gérer les bases de données ServBay avec TablePlus

ServBay est un environnement de développement web local compatible macOS et Windows, intégrant plusieurs langages de programmation, serveurs web et systèmes de gestion de bases de données pour offrir une plateforme tout-en-un à destination des développeurs. Pour gérer facilement les bases de données intégrées dans ServBay, telles que MySQL/MariaDB, PostgreSQL, SQLite, Redis ou MongoDB, il est judicieux d'utiliser un outil tiers puissant et moderne. TablePlus est un client de gestion de base de données intuitif et polyvalent, parfaitement adapté à une utilisation conjointe avec ServBay.

Ce guide détaillé vous accompagne pour connecter et administrer les bases de données ServBay depuis TablePlus sous macOS.

Qu'est-ce que TablePlus ?

TablePlus est un outil GUI avancé et ergonomique pour la gestion de bases de données, compatible avec de nombreux services :

• Bases de données relationnelles : MySQL, MariaDB, PostgreSQL, SQLite, SQL Server
• Bases de données NoSQL : Redis, MongoDB
• Autres : Cassandra, Oracle, etc.

Ses fonctionnalités facilitent le développement, l’administration et la maintenance :

• Interface intuitive : Une interface claire et élégante, facile à prendre en main.
• Performance optimale : Conçu pour gérer efficacement de grands ensembles de données.
• Éditeur de requêtes puissant : Mise en évidence syntaxique, autocomplétion, gestion par onglets multiples.
• Consultation et modification des données : Navigation, insertion, mise à jour et suppression en un clic.
• Gestion de la structure : Administration visuelle des tables, index, vues, etc.
• Connexion sécurisée : Support SSL/TLS pour des connexions chiffrées.

Pour les développeurs utilisant ServBay en environnement local, TablePlus optimise considérablement la manipulation des bases de données.

Connecter les bases de données ServBay à TablePlus

ServBay lance et gère par défaut plusieurs services de bases de données localement. L’état des bases de données installées et actives peut être consulté depuis l’onglet Packages (Logiciels) de l’interface ServBay. Pour connecter ces bases à TablePlus, il faut récupérer les bons paramètres de connexion, accessibles dans l’onglet Databases (Bases de données) de ServBay.

Voici les étapes spécifiques et les réglages pour chaque type de base de données.

Connecter MariaDB ou MySQL

ServBay propose par défaut MariaDB (hautement compatible avec MySQL).

1. Téléchargez et installez TablePlus : Si ce n’est pas déjà fait, téléchargez la version macOS sur le site officiel TablePlus.
2. Ouvrez TablePlus et ajoutez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur le bouton "+" en haut à gauche ou allez dans le menu File -> New -> Connection....
   • Sélectionnez le type : MariaDB ou MySQL.
3. Configurez les réglages de connexion :
   • Nom : Donnez un nom explicite à la connexion, par exemple ServBay MariaDB.
   • Hôte : 127.0.0.1 (connexion locale)
   • Port : 3306 (port par défaut MariaDB/MySQL)
   • Utilisateur : Consultez l’onglet Databases (Bases de données) dans ServBay pour le nom d’utilisateur root (généralement root).
   • Mot de passe : Obtenez le mot de passe root dans le même onglet de ServBay.
   • Base : Laissez vide pour choisir après connexion, ou précisez le nom de la base visée.
   • Alternative : Il est possible d’utiliser la connexion Socket, souvent plus rapide en local.
     • Cochez Use socket file.
     • Chemin du socket : /Applications/ServBay/tmp/mysql.sock (chemin par défaut sous ServBay).
     • Les champs Host et Port sont ignorés avec Socket.
4. Testez et sauvegardez la connexion :
   • Cliquez sur Test pour vérifier les réglages.
   • Si le test est concluant, cliquez sur Connect pour se connecter. Save permet d’enregistrer la configuration pour un usage ultérieur.

Connecter PostgreSQL

ServBay prend aussi en charge PostgreSQL.

1. Ajoutez une nouvelle connexion dans TablePlus :
   • Lancez TablePlus.
   • Cliquez sur "+" ou naviguez vers File -> New -> Connection....
   • Choisissez PostgreSQL.
2. Configurez les réglages :
   • Nom : Par exemple ServBay PostgreSQL.
   • Hôte : 127.0.0.1
   • Port : 5432 (port par défaut)
   • Utilisateur : Trouvez le nom d’utilisateur par défaut (souvent servbay) dans l’onglet Databases de ServBay.
   • Mot de passe : Indiqué dans ServBay.
   • Base : Précisez en général une base initiale, postgres ou celle créée sous ServBay.
   • Alternative : Connexion Socket possible :
     • Cochez Use socket file.
     • Chemin du socket : /Applications/ServBay/tmp/.s.PGSQL.5432.
     • Les champs Host et Port sont ignorés.
3. Testez et enregistrez la connexion :
   • Cliquez sur Test puis sur Connect ou Save.

Connecter SQLite 3

SQLite est une base autosuffisante sans serveur : les données sont stockées dans un fichier. ServBay ne démarre pas de processus serveur pour SQLite, mais vos applications (PHP, Python…) y accèdent via le fichier. TablePlus permet de se connecter directement à ce fichier.

1. Nouvelle connexion dans TablePlus :
   • Lancez TablePlus.
   • Cliquez sur "+" ou menu File -> New -> Connection....
   • Sélectionnez SQLite.
2. Réglages de connexion :
   • Nom : Par exemple ServBay SQLite Project.
   • Fichier de base : Cliquez sur l’icône dossier à droite pour choisir le fichier SQLite (.sqlite, .db, .sqlite3). Il est recommandé de placer ces fichiers dans le dossier du projet ou dans /Applications/ServBay/db/sqlite pour en faciliter la gestion.
3. Testez et sauvegardez :
   • Cliquez sur Test (si le fichier existe et est lisible).
   • Cliquez sur Connect ou Save.

Connecter Redis

Redis est un SGBD clé-valeur haute performance. ServBay peut installer et lancer Redis.

1. Nouvelle connexion dans TablePlus :
   • Lancez TablePlus.
   • Cliquez sur "+" ou menu File -> New -> Connection....
   • Sélectionnez Redis.
2. Réglages :
   • Nom : Par exemple ServBay Redis.
   • Hôte : 127.0.0.1
   • Port : 6379 (port Redis par défaut)
   • Mot de passe : Si vous avez configuré un mot de passe sous ServBay, saisissez-le ; sinon laissez vide (absence de mot de passe par défaut).
3. Testez et sauvegardez :
   • Cliquez sur Test puis sur Connect ou Save.

Connecter MongoDB

ServBay prend en charge l'installation et le démarrage de MongoDB.

1. Créer une nouvelle connexion TablePlus :
   • Lancez TablePlus.
   • Cliquez sur "+" ou menu File -> New -> Connection....
   • Sélectionnez MongoDB.
2. Configurez la connexion :
   • Nom : Par exemple ServBay MongoDB.
   • Hôte : 127.0.0.1
   • Port : 27017 (port MongoDB par défaut)
   • Utilisateur : Si l’authentification a été paramétrée, indiquez le nom d’utilisateur ; sinon laissez vide (par défaut sous ServBay).
   • Mot de passe : Saisissez-le si nécessaire.
   • Base d’authentification : Ex. admin si vous avez activé la sécurité.
   • Base : Laissez vide, ou indiquez la base visée.
3. Testez et sauvegardez :
   • Cliquez sur Test puis sur Connect ou Save.

Gérer les bases de données relationnelles (MariaDB/MySQL, PostgreSQL, SQLite) avec TablePlus

Une fois connecté, TablePlus offre une interface homogène pour administrer ces bases relationnelles.

1. Créer une base de données

• Après connexion (fichier pour SQLite), la barre latérale gauche s’affiche.
• Pour MariaDB/MySQL et PostgreSQL, cliquez sur l’onglet Databases.
• Cliquez sur le bouton "+" en haut à gauche ou faites un clic droit > New Database....
• Saisissez le nom, choisissez l’encodage et le classement si besoin.
• Cliquez sur Save.

2. Créer une table

• Dans la barre latérale, sélectionnez la base concernée.
• Allez sur l’onglet Tables.
• Cliquez sur le "+" ou clic droit > New Table....
• Saisissez le nom de table.
• Définissez les colonnes en bas :
  • Cliquez sur "+" pour ajouter une colonne.
  • Saisissez le nom.
  • Choisissez le type.
  • Définissez la longueur/valeurs si besoin.
  • Cochez PK pour clé primaire, NN non nul, UQ unique, AI auto-incrément, etc.
  • Définissez une valeur par défaut.
  • Ajoutez un commentaire.
• Une fois toutes les colonnes définies, cliquez en haut à gauche sur Save (ou Cmd + S).

3. Ajouter des données

• Sélectionnez la base et la table concernée.
• Dans la vue de données, cliquez en bas sur + Row.
• Une nouvelle ligne apparaît : double-cliquez sur les cellules pour saisir les valeurs.
• Cliquez sur Save (ou Cmd + S) pour enregistrer.

4. Requêter des données

• Sélectionnez la base et la table dans la barre latérale.
• Parcourez les données directement dans la vue.
• Utilisez le champ de filtre en haut pour retrouver plus vite une valeur.
• Pour des requêtes complexes, utilisez l’éditeur SQL de TablePlus :
  • Cliquez sur SQL Query ou Cmd + N.
  • Saisissez la requête (ex. SELECT * FROM votre_table WHERE condition;).
  • Exécutez avec Run Current (icône éclair) ou Cmd + Enter. Les résultats s’affichent en bas.

5. Mettre à jour des données

• Double-cliquez sur la cellule à modifier.
• Saisissez la nouvelle valeur.
• Cliquez sur Save (ou Cmd + S).

6. Supprimer des données

• Sélectionnez une ou plusieurs lignes à supprimer dans la vue.
• Clic droit > Delete Row(s), puis confirmez.
• Cliquez sur Save (ou Cmd + S).

7. Supprimer une table

• Sélectionnez la base et l’onglet Tables.
• Choisissez la ou les tables à supprimer.
• Clic droit > Delete Table(s), saisissez le nom pour confirmer puis Delete.

8. Supprimer une base de données

• Dans l’onglet Databases, sélectionnez la base à effacer.
• Clic droit > Delete Database, tapez le nom pour confirmer puis Delete.
• Pour SQLite : Supprimer la base revient à effacer le fichier .sqlite. Faites-le manuellement dans le système de fichiers.

Gérer les bases NoSQL (Redis, MongoDB) avec TablePlus

TablePlus propose une interface spécifique pour Redis et MongoDB. L’expérience diffère un peu des bases relationnelles.

Gérer les données Redis

Après connexion :

• La barre latérale affiche les bases Redis (DB0, DB1…). DB0 est utilisé par défaut.
• Sélectionnez une base : à droite sont listées toutes les clés.
• Consulter une clé : Parcourez la liste, filtrez en haut. Cliquez sur une clé pour afficher son type et sa valeur, affichée selon le type (string, hash, liste, set, zset…).
• Ajouter une clé : Cliquez sur + Row en bas, sélectionnez le type, le nom et la valeur, puis Save.
• Modifier une clé : Double-cliquez pour éditer le nom ou la valeur, puis Save.
• Supprimer une clé : Sélectionnez une ou plusieurs clés, clic droit > Delete Row(s), puis confirmez.

Gérer les données MongoDB

Après connexion :

• La barre latérale affiche les bases MongoDB.
• Sélectionnez une base pour afficher ses collections à droite.
• Voir les documents d’une collection : Double-cliquez sur le nom de la collection, les documents s’affichent à droite (format JSON/similaire).
• Ajouter un document : Dans la vue, cliquez sur + Row, double-cliquez pour éditer champs/valeurs, puis Save.
• Modifier un document : Double-cliquez sur champs ou valeurs ou éditez le JSON/BSON brut, puis Save.
• Supprimer un document : Sélectionnez, clic droit > Delete Row(s), puis confirmez.
• Créer une collection : Sélectionnez la base, onglet Collections, cliquant sur "+" ou clic droit > New Collection..., nommez et Save.
• Supprimer une collection : Sélectionnez, clic droit > Delete Collection(s), puis confirmez.
• Supprimer une base : Sélectionnez la base, clic droit > Delete Database, puis confirmez.

Points d’attention et FAQ

• Statut ServBay : Avant d’établir la connexion, vérifiez que ServBay fonctionne et que le service (MariaDB, PostgreSQL, Redis, MongoDB) désiré s’affiche comme “en cours d’exécution” dans l’onglet Packages.
• Pare-feu : Surveillez que le pare-feu macOS ou tout logiciel de sécurité ne bloque pas l’accès de TablePlus aux ports locaux (3306, 5432, 6379, 27017).
• Récupérer les identifiants : Les identifiants par défaut sont dans l’onglet Databases de ServBay : conservez-les bien.
• Modifier les mots de passe par défaut : Pour des raisons de sécurité, changez le mot de passe root ou celui de l’utilisateur par défaut. ServBay permet de les réinitialiser dans l’onglet Databases : mettez à jour la configuration TablePlus en conséquence.
• Connexion Socket vs. Port : Le socket (chemin système) est généralement plus performant en local ; la connexion par port TCP/IP fonctionne aussi (ex. 127.0.0.1). Les deux sont compatibles dans ServBay.
• Peut-on utiliser d’autres outils ? Bien sûr ! Vous pouvez aussi recourir à DBeaver, DataGrip, Sequel Ace (MySQL/MariaDB), pgAdmin (PostgreSQL), MongoDB Compass (MongoDB), etc. Choisissez selon vos préférences ; il suffit de renseigner les bons réglages récupérés dans ServBay.

Conclusion

Grâce à ce guide, vous maîtrisez désormais l’utilisation de TablePlus pour connecter et administrer efficacement les bases de données de votre environnement de développement local ServBay sous macOS. L’alliance des fonctionnalités TablePlus et de l'intégration ServBay améliore grandement votre productivité. Pensez à toujours vérifier vos identifiants ServBay pour des connexions fiables. Bon développement !