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

ServBay est un environnement de développement Web local conçu spécialement pour macOS, intégrant plusieurs langages de programmation, serveurs web et systèmes de gestion de bases de données au sein d’une plateforme tout-en-un pour les développeurs. Pour administrer efficacement les bases de données intégrées à ServBay (comme MySQL/MariaDB, PostgreSQL, SQLite, Redis, MongoDB…), il est particulièrement pertinent d’utiliser un outil tiers puissant, tel que TablePlus. TablePlus est un client moderne, intuitif et compatible avec de nombreux types de bases de données, ce qui en fait un excellent compagnon pour ServBay.

Ce guide vous expliquera en détail comment connecter et gérer les différentes bases de données fournies par ServBay via TablePlus sur macOS.

Qu’est-ce que TablePlus ?

TablePlus est un outil graphique de gestion de bases de données, à la fois puissant et convivial. Il prend en charge une grande variété de systèmes, dont, entre autres :

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

TablePlus offre un ensemble de fonctionnalités conçues pour simplifier le développement, l’administration et la maintenance des bases de données :

• Interface intuitive : une interface claire et épurée, facile à prendre en main.
• Réactivité : optimisée pour les performances, même sur de gros volumes de données.
• Éditeur de requêtes performant : prise en charge de la coloration syntaxique, de la complétion automatique et des onglets multiples.
• Édition et visualisation des données : navigation, insertion, modification ou suppression des données de manière fluide.
• Gestion des structures : administration visuelle des tables, index, vues, etc.
• Connexion sécurisée : compatible avec le chiffrement SSL/TLS.

Pour les développeurs travaillant en local sur ServBay, TablePlus permet d’accélérer et de simplifier de nombreuses opérations sur les bases de données.

Connecter les bases de données ServBay à TablePlus

ServBay lance par défaut plusieurs services de bases de données en local. Le statut des bases installées et leur disponibilité s’affiche dans l’onglet Paquets (Packages). Pour connecter ces bases à TablePlus, il vous faudra renseigner les bons paramètres de connexion, que vous trouverez dans l’onglet Bases de données (Databases) de ServBay.

Voici les étapes précises et les paramètres nécessaires pour configurer chaque type de connexion dans TablePlus.

Connexion à MariaDB ou MySQL

MariaDB (largement compatible MySQL) est installé par défaut avec ServBay.

1. Téléchargez et installez TablePlus : si ce n’est pas déjà fait, téléchargez le client TablePlus pour macOS depuis le site officiel TablePlus.
2. Ouvrez TablePlus et créez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur l’icône "+" en haut à gauche ou via le menu Fichier -> Nouveau -> Connexion....
   • Choisissez MariaDB ou MySQL comme type de base de données.
3. Configurez les informations de connexion :
   • Nom : Donnez un nom reconnaissable à la connexion, par exemple ServBay MariaDB.
   • Hôte : 127.0.0.1 (connexion locale)
   • Port : 3306 (port par défaut MariaDB/MySQL)
   • Utilisateur : Trouvez le nom d’utilisateur root dans l’onglet Bases de données (Databases) de ServBay (généralement root).
   • Mot de passe : Depuis le même onglet, récupérez le mot de passe root.
   • Base de données : Laissez vide pour choisir après la connexion, ou renseignez le nom de la base souhaitée.
   • Alternative : Il est également possible d’utiliser la connexion par Socket, souvent un peu plus rapide et directe que TCP/IP.
     • Cochez Utiliser un fichier Socket.
     • Chemin du Socket : /Applications/ServBay/tmp/mysql.sock (socket par défaut de MariaDB/MySQL par ServBay).
     • En mode Socket, les champs Hôte et Port sont ignorés.
4. Testez et validez la connexion :
   • Cliquez sur Test en bas à droite pour vérifier vos paramètres.
   • Si la connexion réussit, cliquez sur Connecter. Vous pouvez aussi cliquer sur Enregistrer pour conserver la configuration pour une utilisation ultérieure.

Connexion à PostgreSQL

PostgreSQL est également supporté par ServBay.

1. Ouvrez TablePlus et créez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur l’icône "+" ou via Fichier -> Nouveau -> Connexion....
   • Sélectionnez PostgreSQL comme type de base.
2. Paramétrez la connexion :
   • Nom : Par exemple ServBay PostgreSQL.
   • Hôte : 127.0.0.1
   • Port : 5432 (port standard PostgreSQL)
   • Utilisateur : Retrouvez l’utilisateur par défaut PostgreSQL dans l’onglet Bases de données (Databases) de ServBay (souvent servbay).
   • Mot de passe : Depuis le même onglet, récupérez le mot de passe associé.
   • Base de données : PostgreSQL nécessite de renseigner une base initiale, par exemple postgres ou celle de votre projet.
   • Alternative : Connexion via Socket possible.
     • Cochez Utiliser un fichier Socket.
     • Chemin du Socket : /Applications/ServBay/tmp/.s.PGSQL.5432 (socket par défaut pour PostgreSQL par ServBay).
     • Comme précédemment, Hôte et Port sont alors ignorés.
3. Test et validation :
   • Cliquez sur Test pour vérifier la connexion.
   • Puis sur Connecter ou Enregistrer.

Connexion à SQLite 3

SQLite est un moteur sans serveur : les données sont stockées dans un fichier. ServBay ne « démarre » pas de service SQLite distinct, mais fournit l’environnement (PHP PDO, Python sqlite3…) pour y accéder. TablePlus peut lui aussi se connecter directement à ces fichiers.

1. Ouvrez TablePlus et créez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur "+" ou via Fichier -> Nouveau -> Connexion....
   • Choisissez SQLite.
2. Configurez la connexion :
   • Nom : Par exemple ServBay SQLite Project.
   • Fichier base de données : Cliquez sur l’icône de dossier à droite pour sélectionner le fichier SQLite correspondant (extensions .sqlite, .db, .sqlite3...). Il est conseillé de stocker vos fichiers dans le dossier de votre projet ou dans /Applications/ServBay/db/sqlite (dossier recommandé par ServBay).
3. Test et validation :
   • Cliquez sur Test si le fichier existe.
   • Puis Connecter ou Enregistrer.

Connexion à Redis

Redis est un système de base de données clé-valeur très performant. ServBay peut l’installer et le lancer.

1. Ouvrez TablePlus et créez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur "+" ou via Fichier -> Nouveau -> Connexion....
   • Sélectionnez Redis.
2. Configurez la connexion :
   • Nom : Par exemple ServBay Redis.
   • Hôte : 127.0.0.1
   • Port : 6379 (port standard pour Redis)
   • Mot de passe : Si un mot de passe est configuré dans ServBay pour Redis, renseignez-le ici. Par défaut, il n’y en a souvent pas ; le champ peut donc rester vide.
3. Test et validation :
   • Cliquez sur Test pour vérifier la connexion.
   • Puis sur Connecter ou Enregistrer.

Connexion à MongoDB

ServBay est compatible avec MongoDB.

1. Ouvrez TablePlus et créez une nouvelle connexion :
   • Lancez TablePlus.
   • Cliquez sur "+" ou via Fichier -> Nouveau -> Connexion....
   • Choisissez MongoDB.
2. Configurez la connexion :
   • Nom : Par exemple ServBay MongoDB.
   • Hôte : 127.0.0.1
   • Port : 27017 (port par défaut MongoDB)
   • Utilisateur : Si l’authentification est activée, saisissez l’identifiant. Sur une installation ServBay par défaut, l’authentification MongoDB n’est souvent pas activée – laissez alors les champs utilisateur et mot de passe vides.
   • Mot de passe : Complétez seulement si l’authentification est activée.
   • Base d’authentification : Si besoin, indiquez la base correspondante (souvent admin).
   • Base de données : Laissez vide pour choisir après connexion, ou indiquez la base cible.
3. Test et validation :
   • Cliquez sur Test pour valider la configuration.
   • Puis sur Connecter ou Enregistrer.

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

Une fois la connexion réussie, TablePlus propose une interface et une logique d’utilisation similaires pour la gestion des bases relationnelles.

1. Créer une base de données

• Une fois connecté au serveur (ou au fichier pour SQLite), utilisez la colonne de gauche.
• Pour MariaDB/MySQL et PostgreSQL, sélectionnez l’onglet Bases de données (Databases).
• Cliquez sur le bouton "+" en haut à gauche ou effectuez un clic droit puis sélectionnez Nouvelle base de données....
• Indiquez le nom, choisissez le jeu de caractères et le collationnement si nécessaire.
• Cliquez sur Enregistrer.

2. Créer une table

• Dans la colonne de gauche, choisissez la base concernée.
• Rendez-vous sur l’onglet Tables.
• Cliquez sur le bouton "+" ou clic droit puis Nouvelle table....
• Indiquez le nom.
• Définissez les colonnes dans la zone inférieure :
  • Cliquez sur "+" pour chaque nouvelle colonne.
  • Ajoutez le nom de colonne.
  • Sélectionnez le type de données.
  • Renseignez taille/valeurs si besoin.
  • Cochez PK (clé primaire), NN (non nul), UQ (unique), AI (auto-incrément), etc., selon les besoins.
  • Définissez les valeurs par défaut, ajoutez des commentaires si nécessaire.
• Une fois toutes les colonnes créées, cliquez sur Enregistrer ou utilisez Cmd + S.

3. Ajouter des données

• Dans la colonne de gauche, sélectionnez la base, puis la table souhaitée dans l’onglet Tables.
• Dans la vue des données, cliquez sur + Ligne en bas.
• Une nouvelle ligne vide s’affiche : double-cliquez pour saisir les valeurs.
• Cliquez sur Enregistrer ou tapez Cmd + S quand la saisie est terminée.

4. Interroger les données

• Sélectionnez la base et la table dans la colonne de gauche.
• Parcourez les données dans la vue tableau.
• Utilisez la barre de recherche rapide pour filtrer.
• Pour des requêtes plus complexes, ouvrez l’éditeur SQL :
  • Cliquez sur Requête SQL dans la barre d’outils ou tapez Cmd + N.
  • Saisissez votre requête SQL (ex: SELECT * FROM votre_table WHERE condition;).
  • Lancez l’exécution (icône éclair) ou tapez Cmd + Entrée. Le résultat s’affichera en bas.

5. Mettre à jour des données

• Dans la vue des données, double-cliquez sur une cellule pour la modifier.
• Saisissez la nouvelle valeur.
• Cliquez sur Enregistrer ou tapez Cmd + S.

6. Supprimer des données

• Sélectionnez une ou plusieurs lignes à supprimer dans la vue des données.
• Clic droit puis Supprimer la/les ligne(s).
• Confirmez dans la boîte de dialogue, puis cliquez sur Supprimer.
• Cliquez sur Enregistrer ou Cmd + S pour appliquer la suppression.

7. Supprimer une table

• Sélectionnez la base concernée dans la colonne de gauche.
• Accédez à l’onglet Tables.
• Sélectionnez une ou plusieurs tables à supprimer.
• Clic droit puis Supprimer la/les table(s).
• Confirmez en saisissant le nom de la table, puis cliquez sur Supprimer.

8. Supprimer une base de données

• Pour MariaDB/MySQL ou PostgreSQL, sélectionnez l’onglet Bases de données dans la colonne de gauche.
• Sélectionnez la base à supprimer.
• Clic droit puis Supprimer la base de données.
• Confirmez en saisissant le nom de la base, puis cliquez sur Supprimer.
• SQLite : il suffit de supprimer le fichier .sqlite correspondant depuis le système de fichiers.

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

TablePlus propose une interface spécifique pour Redis et MongoDB, adaptée à la logique NoSQL de ces bases.

Gérer les données Redis

Une fois connecté à Redis :

• La colonne gauche affiche la liste des bases Redis (DB0, DB1, ...). La base par défaut est généralement DB0.
• Sélectionnez une base : les clés seront listées à droite.
• Voir une clé : naviguez et cliquez sur le nom pour connaître son type et sa valeur. Les types (chaîne, hash, liste, ensemble, trié…) sont affichés de manière adaptée.
• Ajouter une clé : cliquez sur + Ligne en bas, sélectionnez le type, indiquez le nom et la valeur, puis Enregistrer.
• Modifier une clé : double-cliquez sur son nom ou sa valeur, puis Enregistrer après modification.
• Supprimer une clé : sélectionnez et faites clic droit puis Supprimer la/les ligne(s), puis confirmez.

Gérer les données MongoDB

Après connexion à MongoDB :

• La colonne gauche affiche les bases MongoDB disponibles.
• Choisissez une base, puis les collections s’affichent à droite.
• Voir une collection : double-cliquez sur son nom pour afficher les documents (format JSON ou équivalent).
• Ajouter un document : cliquez sur + Ligne en bas. Un nouveau document vide apparaît : double-cliquez pour éditer champs et valeurs, puis Enregistrer.
• Modifier un document : double-cliquez sur les champs ou éditez en JSON/BSON brut, puis sauvegardez.
• Supprimer un document : sélectionnez un ou plusieurs documents, clic droit puis Supprimer la/les ligne(s) puis confirmez.
• Créer une collection : sélectionnez la base à gauche, allez dans l’onglet Collections, puis cliquez sur "+" ou clic droit puis Nouvelle collection.... Entrez le nom et cliquez sur Enregistrer.
• Supprimer une collection : même logique que précédemment, mais via Supprimer la/les collection(s) puis confirmation.
• Supprimer une base : clic droit sur la base dans la colonne de gauche, puis Supprimer la base de données, et validez.

Remarques et FAQ

• État de ServBay : Avant toute tentative de connexion, vérifiez que l’application ServBay est lancée et que le service concerné (MariaDB, PostgreSQL, Redis, MongoDB…) est bien marqué comme « en cours d’exécution » dans l’onglet Paquets (Packages).
• Pare-feu/sécurité : Assurez-vous que le pare-feu macOS ou tout logiciel de sécurité ne bloque pas les ports locaux de base de données (3306, 5432, 6379, 27017).
• Obtenir les identifiants : Les identifiants et mots de passe par défaut des bases sont consultables à tout moment dans l’onglet Bases de données (Databases) de ServBay. Conservez ces informations en sécurité.
• Modifier les mots de passe par défaut : Il est conseillé, pour des raisons de sécurité, de modifier les mots de passe root ou par défaut depuis l’onglet Bases de données (Databases) ServBay. Une option de réinitialisation y est généralement disponible ; pensez à mettre à jour la configuration TablePlus après modification.
• Connexion Socket vs Port :
  • La connexion Socket passe par le système de fichiers pour transmettre les données entre processus, ce qui peut offrir de meilleures performances en local et court-circuite la configuration réseau.
  • La connexion par Port/TCP/IP permet soit une communication locale (127.0.0.1), soit le dialogue avec des serveurs distants.
  • Dans l’environnement local ServBay, les deux options conviennent généralement.
• Peut-on utiliser d’autres outils ? Évidemment ! En plus de TablePlus, il existe bon nombre d’outils dédiés à la gestion des bases de données, comme DBeaver, DataGrip, Sequel Ace (MySQL/MariaDB), pgAdmin (PostgreSQL), Compass (MongoDB), etc. Le principe de connexion reste identique : toujours récupérer vos paramètres dans l’onglet Bases de données (Databases) de ServBay.

Conclusion

Grâce à ce guide, vous êtes désormais en mesure de connecter et de gérer efficacement toutes les bases de données locales ServBay sous macOS à l’aide de TablePlus. Le puissant éventail de fonctionnalités de TablePlus allié à la simplicité du développement local dans ServBay amélioreront grandement votre productivité. Rappelez-vous : disposer des bons identifiants depuis ServBay est la clef de toute connexion réussie. Excellente continuation dans vos développements !