Cette page décrit Calíope 1.5, la version que je construis en ce moment. La 1.4 est sur l'App Store pour Mac, iPad, iPhone, Apple Watch, Apple TV et Apple Vision Pro. Le changelog indique dans quelle version chaque fonction est arrivée.
Ajoute un bouton « Ouvrir dans Calíope » à chaque sujet. Ne fonctionne qu'avec l'app installée.
Enregistrez les informations d'un serveur pour vous connecter rapidement.
Où le trouver : Panneau latéral › Bouton + (nouvelle connexion)
Dans le Gestionnaire de connexions, appuyez sur + dans la barre latérale gauche. Saisissez un nom descriptif, la famille du serveur (le protocole qu'il parle) et le produit dans celle-ci, puis l'hôte, le port, l'utilisateur et le mot de passe. Le champ « Base de données par défaut » est optionnel.
Dans la section Options du serveur, vous pouvez configurer le jeu de caractères, la collation et activer SSL/TLS. Si SSL est activé, des champs apparaissent pour sélectionner le certificat et la clé du client.
Mots-clés : profil, nouvelle connexion, enregistrer serveur, hôte, configurer
Où le trouver : Panneau latéral › Liste de profils
Sélectionnez le profil dans la liste de la barre latérale. Le formulaire à droite se charge avec ses données actuelles et vous pouvez modifier n'importe quel champ directement. Il n'y a pas de bouton Enregistrer : chaque modification est enregistrée dès que vous la faites.
Supprimer un profil a son propre thème, car c'est irréversible et cela emporte plus de choses qu'il n'y paraît : voir Supprimer une connexion.
Les trois endroits d'où l'on supprime un profil, ce qui part avec lui, et pourquoi c'est irréversible.
Où le trouver : Panneau latéral › Bouton − (supprimer la connexion)
Supprimer une connexion n'efface pas seulement son adresse et son nom d'utilisateur : cela emporte tout ce que Calíope avait enregistré de ce serveur. C'est pour cela qu'il demande d'abord, et que la question dit le nom de la connexion — si ce n'est pas celle que vous croyiez, c'est le moment de le découvrir.
D'où
- macOS : sélectionnez le profil et cliquez sur − dans la barre sous la liste, à côté du +. Ou faites un clic droit sur la ligne et choisissez Supprimer.
- iPad : sélectionnez le profil et touchez − dans la barre inférieure ; ou maintenez appuyée la ligne et choisissez Supprimer ; ou balayez la ligne de droite à gauche. Le balayage ne supprime pas quand vous relâchez : il révèle le bouton, et la question arrive quand même. Balayer dans l'autre sens — de gauche à droite — c'est Déplacer vers le groupe.
Ce qui part avec elle
- Le profil et toutes ses données.
- Son mot de passe du trousseau, ainsi que celui de SSH et la phrase secrète de sa clé privée.
- Son historique de requêtes, et ses lignes dans le journal d'erreurs et dans le journal des messages du serveur.
- Le SQL qu'elle avait enregistré dans l'éditeur de cette connexion, et son cache de schéma.
C'est irréversible. Il n'y a ni corbeille ni annulation : la confirmation est la seule occasion de faire marche arrière.
Sur vos autres appareils. Avec la synchronisation iCloud activée, la suppression voyage et la connexion disparaît là-bas aussi. Dans l'autre sens rien d'étrange ne se produit : un profil créé sur l'autre machine et que celle-ci n'a pas encore vu n'est pas lu comme une suppression, il ne disparaît donc pas tout seul.
Un groupe entier. Supprimer un groupe supprime aussi les connexions qu'il contient, avec la même question et la même portée ; c'est expliqué dans Organiser les profils en groupes.
Mots-clés : supprimer connexion, supprimer profil, retirer serveur, annuler, corbeille, mot de passe, trousseau, balayer
Comment utiliser l’hôte alternatif lorsque l’adresse du serveur dépend de l’appareil depuis lequel vous vous connectez.
Où le trouver : Panneau latéral › Connexions › Hôte alternatif
Le champ « Hôte alternatif » du profil sert pour un serveur que l’on atteint par deux adresses différentes. Le cas typique est une machine de développement : depuis l’ordinateur lui-même, elle répond sur 127.0.0.1, tandis que depuis l’iPad il faut utiliser son adresse sur le réseau local. Comme les profils se synchronisent entre vos appareils, un seul champ d’hôte ne peut pas être juste des deux côtés.
À la connexion, l’hôte principal est essayé en premier. S’il ne répond pas, l’alternatif est essayé avec le même port, le même utilisateur, le même mot de passe et les mêmes options : seule l’adresse change. S’il vous faut aussi un autre port, écrivez « adresse:port » (par exemple, 10.0.0.20:3307).
Quand la session passe par l’adresse alternative, un repère apparaît à côté du nom du serveur et « Tester la connexion » indique quelle adresse a répondu, afin que vous sachiez toujours sur quelle machine vous travaillez.
Avec un tunnel SSH, le champ est ignoré, et c’est voulu : l’adresse du serveur y est résolue par la machine du tunnel, pas par votre appareil, elle ne change donc pas selon l’endroit d’où vous vous connectez.
Mots-clés : hôte alternatif, seconde adresse, ip locale, réseau local, bascule, 127.0.0.1, ipad, deux adresses
Quand faut-il l'écrire, quels champs Calíope cesse d'utiliser dans ce cas, et où finit le mot de passe.
Où le trouver : Panneau latéral › Connexions › Chaîne de connexion
Le champ « Chaîne de connexion » n'apparaît que si le moteur du profil est MongoDB, et il est facultatif. Si vous le laissez vide, Calíope construit la connexion avec les champs du dessus : adresse, port, utilisateur, mot de passe, TLS et base de données. Pour un serveur ordinaire, cela suffit.
Écrivez-la quand la connexion ne peut pas se décrire avec ces champs. Trois cas : un jeu de réplicas, qui exige plusieurs adresses et le nom du jeu ; une base d'authentification différente de l'habituelle, indiquée par authSource ; et un cluster Atlas, dont l'adresse commence par mongodb+srv:// et n'a pas de port à saisir.
Quand vous l'écrivez, elle l'emporte sur les champs du dessus : utilisateur, mot de passe, TLS et options en proviennent. Il y a deux exceptions. Si le profil utilise un tunnel SSH, l'adresse vient du tunnel et non de la chaîne, car le serveur que nomme la chaîne est celui que voit la machine du tunnel, pas votre appareil. Et si la chaîne ne nomme aucune base de données, celle du profil est utilisée, ou admin à défaut.
Sans chaîne, l'authentification se fait contre admin. C'est là que vivent les comptes d'administration et c'est ce que supposent mongosh et Compass quand on saisit simplement un utilisateur et un mot de passe ; si les vôtres sont dans une autre base, précisez-le avec authSource.
Un avertissement sur le mot de passe : celui du champ du dessus est enregistré dans le trousseau, mais un mot de passe écrit dans la chaîne, non. La chaîne est enregistrée avec le reste du profil et, si la synchronisation iCloud est active, elle voyage avec lui. Si cela vous importe, laissez le mot de passe dans son champ et n'utilisez la chaîne que pour le reste.
Si la chaîne est mal formée, la connexion échoue en le disant : c'est une erreur de formulaire, elle se corrige là et non en réessayant.
Mots-clés : chaîne de connexion, mongodb, uri, srv, atlas, jeu de réplicas, replica set, authSource, mongodb+srv
Vérifiez les informations du serveur avant de vous connecter.
Où le trouver : Gestionnaire de connexions › Tester la connexion
Appuyez sur Tester la connexion dans le formulaire du profil. Calíope tente d'ouvrir une connexion réelle avec les informations saisies et affiche le résultat dans une bannière verte (succès) ou rouge (erreur avec description).
Le test est particulièrement utile pour valider les identifiants SSL, les pare-feux ou les configurations d'hôte avant d'enregistrer le profil.
Établissez la connexion et ouvrez l'Espace de travail.
Où le trouver : Gestionnaire de connexions › Se connecter
Une fois les informations du profil complétées, appuyez sur le bouton Connexion (icône d'éclair). Calíope ouvre le pool de connexions avec le pilote du moteur et charge l'arborescence des schémas.
Si la connexion échoue, un message d'erreur apparaît dans la barre d'état. Vérifiez l'hôte, les identifiants et que le serveur est actif et accessible depuis votre réseau.
Mots-clés : connexion, connecter, ouvrir workspace, pool
Changez la base de données de la session depuis le panneau de schéma.
Où le trouver : Éditeur SQL › Panneau de schéma › Définir comme base de données active
Dans le panneau de schéma de l'Éditeur SQL, faites un clic droit sur une base de données et choisissez Définir comme base de données active. La session y passe sans se reconnecter — cela équivaut à exécuter USE nom_bd — et le menu serveur affiche son nom à côté de celui du serveur. Le changement n'affecte que la session en cours.
Mots-clés : use database, changer base de données, sélectionner base de données
Déconnectez-vous du serveur et revenez au Gestionnaire de connexions.
Où le trouver : Espace de travail › Déconnecter
Appuyez sur le bouton Déconnecter dans l'en-tête de l'Espace de travail. Calíope ferme le pool de connexions et revient à l'écran du Gestionnaire de connexions avec une animation.
La déconnexion est automatique lors de la fermeture de la fenêtre principale de l'application.
Reconnectez-vous automatiquement si le serveur ferme la session.
Où le trouver : Panneau latéral › Formulaire profil › Reconnexion automatique
Dans le formulaire du profil de connexion, activez le commutateur Reconnexion automatique. Avec cette option active, Calíope tentera de rétablir la connexion automatiquement si le serveur la ferme en raison d'une inactivité ou d'un redémarrage.
Utile pour les sessions longues ou pour les serveurs avec un délai d'expiration de connexion court.
Travaillez avec plusieurs serveurs en même temps sans perdre le contexte.
Où le trouver : Espace de travail › Menu serveur
Calíope prend en charge plusieurs connexions actives à des serveurs simultanément. Chaque serveur dispose de sa propre session indépendante avec son propre arbre de schémas, ses onglets SQL ouverts, son historique de requêtes et l'état de l'assistant IA.
Fonctionnement :
Chaque fois que vous appuyez sur Connexion dans le Gestionnaire de connexions, une nouvelle session s'ouvre sans fermer les précédentes. Toutes les sessions coexistent et vous pouvez basculer entre elles sans rien perdre.
État de chaque session :
- Les onglets SQL et leur contenu sont conservés lors du changement de serveur.
- L'arbre des schémas affiche les bases de données du serveur actif.
- L'assistant IA conserve son historique de conversation par session.
Vous pouvez ouvrir autant de sessions que nécessaire — par exemple, pour comparer des données entre les environnements de développement, de staging et de production simultanément.
Mots-clés : multi-serveur, connexions multiples, simultané, plusieurs connexions, sessions, multiserver
Basculez entre les serveurs connectés depuis le menu déroulant de l'Espace de travail.
Où le trouver : Espace de travail › Menu serveur
Le menu de sélection du serveur affiche le nom du serveur actif et un indicateur d'état de connexion (point vert = connecté, rouge = erreur). En appuyant dessus, un menu s'affiche avec toutes les sessions ouvertes.
Sur macOS : le sélecteur apparaît dans la barre d'outils de la fenêtre, dans le coin supérieur gauche. Il affiche le nom du serveur, la base de données active et la flèche déroulante.
Sur iPad : le sélecteur apparaît à gauche de la barre d'onglets, toujours visible en haut de l'Espace de travail.
Options du menu :
- Appuyez ou cliquez sur le nom de n'importe quel serveur pour activer cette session.
- La session active est marquée d'un ✓.
- Ajouter un serveur ouvre le Gestionnaire de connexions par-dessus l'Espace de travail actuel pour se connecter à un autre serveur sans perdre les sessions ouvertes.
- Déconnecter ferme la session du serveur actif.
Connectez-vous à un serveur supplémentaire sans quitter votre travail actuel.
Où le trouver : Espace de travail › Menu serveur › Ajouter un serveur
Pour ajouter une nouvelle connexion pendant que vous travaillez déjà sur un autre serveur :
1. Ouvrez le menu de sélection du serveur (dans la barre d'outils de la fenêtre sur macOS, dans la barre d'onglets sur iPad).
2. Choisissez Ajouter un serveur.
3. Le Gestionnaire de connexions s'ouvre : dans sa propre fenêtre sur macOS, en feuille sur iPad.
4. Sélectionnez un profil existant ou créez-en un nouveau et appuyez sur Connexion.
5. Le Gestionnaire de connexions se ferme tout seul et la nouvelle session devient disponible dans le sélecteur.
Les sessions précédentes restent ouvertes et intactes tout au long du processus.
Mots-clés : ajouter serveur, nouvelle session, deuxième connexion, connecter autre serveur
Fermez la session d'un serveur sans affecter les autres connexions actives.
Où le trouver : Espace de travail › Déconnecter
Lorsque vous avez plusieurs sessions ouvertes, vous pouvez fermer n'importe laquelle de façon indépendante :
Serveur actif :
- Ouvrez le menu de sélection du serveur et appuyez sur Déconnecter, ou utilisez le bouton rouge de déconnexion dans la barre d'outils.
N'importe quelle session (en y basculant d'abord) :
1. Ouvrez le menu de sélection du serveur.
2. Sélectionnez le serveur que vous souhaitez fermer pour l'activer.
3. Appuyez sur Déconnecter.
Lors de la fermeture d'une session, Calíope active automatiquement la dernière session disponible. Si c'était la seule session ouverte, il revient au Gestionnaire de connexions.
Chiffrez la connexion au serveur avec des certificats SSL.
Où le trouver : Panneau latéral › Formulaire profil › SSL
Dans le formulaire du profil de connexion, activez le commutateur SSL dans la section Options du serveur. Trois champs optionnels apparaissent pour les certificats du client :
- Certificat CA — fichier du certificat de l'Autorité de Certification (.pem ou .crt). Calíope utilise ce fichier pour vérifier l'identité du serveur.
- Certificat client — fichier du certificat du client pour l'authentification mutuelle.
- Clé client — clé privée correspondant au certificat du client.
Si vous activez SSL sans fournir de certificat CA, Calíope vérifie le certificat du serveur par rapport aux autorités de certification du système (comportement par défaut sécurisé). Si le serveur utilise un certificat auto-signé, la connexion échouera à moins que vous ne fournissiez le CA correspondant.
Accepter un certificat non vérifié (non sécurisé) : cochez cette case uniquement si vous vous connectez à un serveur de développement avec un certificat auto-signé et que vous ne pouvez pas fournir le CA. La connexion reste chiffrée mais est vulnérable aux attaques de l'homme du milieu. À ne pas activer pour les serveurs de production.
Où se trouve le fichier : quand vous choisissez un CA, un certificat ou une clé client — ou le collez, sur iPad —, Calíope garde sa propre copie sur cet appareil, jamais dans iCloud Drive, et le profil pointe vers cette copie. Vous pouvez ensuite déplacer ou supprimer l'original, et sur le Mac il est toujours lu après un relancement. Pour renouveler un certificat, choisissez-le de nouveau, même s'il porte le même nom. Le fichier reste sur l'appareil où vous l'avez choisi, et son emplacement aussi : un profil configuré sur un autre appareil arrive sans lui. Avant de vous connecter, la liste des connexions affiche Choisissez ses fichiers sur cet appareil et le formulaire indique « Ce profil utilise un certificat choisi sur un autre appareil : choisissez-le ici. » ; choisissez-le là-bas, et dès lors cet appareil garde sa propre copie.
Si un fichier ne peut pas être lu, Calíope ne se connecte pas sans lui : il s'arrête avec « Impossible de lire un fichier TLS », qui nomme le fichier et lequel des trois il est.
La connexion SSL est testée lorsque vous appuyez sur Tester la connexion ; la bannière verte confirmera si le chiffrement est actif.
Exigez Touch ID ou Face ID avant de vous connecter à n'importe quel serveur.
Où le trouver : Panneau latéral › Préférences › Général › Sécurité
Calíope peut demander Touch ID (Mac) ou Face ID (iPad et iPhone) avant d'ouvrir toute connexion. C'est un seul interrupteur pour toute l'application, pas un réglage de chaque profil.
Où l'activer
- Préférences › Général › Sécurité › Exiger Touch ID pour se connecter (ou Exiger Face ID pour se connecter), sur le Mac comme sur l'iPad. Il n'apparaît que si l'appareil dispose de la biométrie.
Une fois activé, Connexion demande d'abord, et si l'authentification échoue la connexion n'aboutit pas. Tester un profil ne demande rien. Vérifiez les autorisations dans Réglages Système › Touch ID et mot de passe (Mac) ou Réglages › Face ID et code (iPad).
Comment regrouper vos connexions (Production, Développement, Client X, etc.) et déplacer des profils entre groupes sur macOS, iPad et iPhone.
Où le trouver : Gestionnaire de connexions › clic droit › Déplacer vers le groupe
Lorsque la liste des connexions grandit, vous pouvez les regrouper par environnement, client ou tout autre critère. Les groupes sont pliables et persistent dans connections.json sous forme de collections ordonnées.
Créer un groupe
- macOS : clic droit sur n'importe quel groupe existant (ou sur l'en-tête de la barre latérale) et choisissez Nouveau groupe. Il est créé avec le nom par défaut Nouveau groupe et passe immédiatement en mode d'édition pour que vous le renommiez.
- iPad : depuis le Gestionnaire de connexions, touchez le menu ⋯ dans la barre supérieure et choisissez Nouveau groupe, ou éditez les groupes depuis la feuille Gérer les groupes.
Renommer / supprimer
- macOS : clic droit sur le nom du groupe → Renommer le groupe ou Supprimer le groupe.
- iPad : pour renommer, touchez le crayon de la ligne dans la feuille Gérer les groupes ; pour supprimer, balayez cette ligne de droite à gauche. Vous pouvez aussi maintenir l'en-tête du groupe dans la liste.
- Supprimer un groupe supprime aussi les connexions qu'il contient, avec leur mot de passe enregistré, leur historique de requêtes et le SQL qu'elles avaient enregistré. Avant de supprimer quoi que ce soit, Calíope demande confirmation et indique combien de connexions partent et comment elles s'appellent. C'est irréversible : si vous voulez seulement défaire le regroupement, sortez d'abord les profils avec Déplacer vers le groupe ▸ Sans groupe.
Déplacer un profil
- macOS : clic droit sur le profil → Déplacer vers le groupe ▸ → choisissez le groupe cible ou Sans groupe pour le retirer de tout regroupement.
- iPad : balayez le profil de gauche à droite pour révéler l'action Déplacer (icône dossier, couleur indigo) ; la feuille de sélection de groupe s'ouvre.
Réordonner les groupes (iPad)
- Ouvrez Gérer les groupes et faites glisser avec la poignée ☰ pour réordonner. L'ordre persiste dans le champ sortOrder de chaque groupe.
Développer/replier
- Chaque groupe dispose d'un ▸ pour replier/développer sa liste de profils. L'état est enregistré par groupe.
Persistance
- Les groupes et leurs affectations vivent dans le fichier connections.json sur l'appareil actuel. Si la synchronisation iCloud est activée, ils sont partagés entre vos appareils.
Filtrer
- Le champ au-dessus de la liste ne laisse que les connexions correspondantes ; tant qu'il contient du texte, tous les groupes sont dessinés ouverts sans modifier ce que vous avez enregistré (voir Filtrer la liste des connexions).
Tapez dans le champ au-dessus de la liste pour ne garder que les connexions qui correspondent, par nom, hôte ou groupe.
Avec trente ou quarante profils, déplier un groupe ne suffit plus. Le champ en haut de la barre latérale ne laisse que les connexions qui correspondent à ce que vous tapez.
Ce qu'il cherche : le nom du profil, son hôte et son hôte alternatif, la base par défaut, le nom d'utilisateur, le nom du moteur et le nom de son groupe. Taper le nom d'un groupe l'affiche donc en entier — c'est la façon de dire montre-moi la production. Les accents et les majuscules n'ont pas d'importance.
Pendant le filtrage, les groupes s'ouvrent tout seuls, y compris ceux que vous aviez repliés, pour que rien de correspondant ne reste caché dans un groupe fermé. Cette ouverture n'est pas enregistrée : videz le champ et chaque groupe revient exactement comme vous l'aviez laissé.
La sélection ne bouge pas. Si le profil que vous éditiez sort du filtre, le formulaire de droite continue de l'afficher : perdre ce que vous éditiez parce que vous avez tapé dans une recherche serait pire que le problème que la recherche résout.
Appuyez sur Échap ou sur le × pour vider le champ. Le filtre n'est pas conservé à la fermeture de l'app.
Ce qu'est une famille, ce qu'est un produit, et comment Calíope propose le produit que le serveur déclare être lorsque vous testez la connexion.
Où le trouver : Panneau latéral › Gestionnaire de connexions
Calíope regroupe les serveurs par famille, c'est-à-dire le protocole qu'il parle : MySQL / MariaDB, PostgreSQL, SQL Server et MongoDB. Dans chaque famille, vous choisissez le produit : le nom précis de ce que vous avez devant vous.
Familles et produits
- MySQL / MariaDB : MySQL, MariaDB, Amazon Aurora MySQL et « Autre compatible MySQL ».
- PostgreSQL : PostgreSQL, Amazon Aurora PostgreSQL et « Autre compatible PostgreSQL ».
- SQL Server : Microsoft SQL Server.
- MongoDB : MongoDB et « Autre compatible MongoDB ».
Ce que décide chacun. La famille décide avec quel moteur Calíope se connecte et quels outils sont proposés. Le produit fixe le nom, l'invite du terminal et les fragments préchargés ; Aurora MySQL, par exemple, apporte les siens. Un produit qui n'est pas la référence de sa famille affiche un avis dans le formulaire pour le rappeler ; vous pouvez le masquer avec Ne plus afficher.
Créer le profil
1. Sous Serveur (Type sur iPad et iPhone), choisissez la famille.
2. Sous Produit, qui sur le Mac est le menu d'à côté, choisissez le produit. Si le vôtre n'y est pas, choisissez « Autre compatible… ».
3. Renseignez hôte, port, utilisateur et mot de passe comme d'habitude. Avec Aurora, collez l'endpoint du cluster et activez SSL/TLS.
Le serveur dit qui il est. Lorsque vous appuyez sur Tester la connexion ou chargez la liste des bases, Calíope interroge le serveur et, s'il s'identifie comme un autre produit de la même famille, le propose sous le sélecteur : appuyez sur Utiliser … pour corriger le profil, ou ignorez-le. Il ne le change jamais de lui-même. MongoDB n'est pas interrogé.
Remarque
Les fonctions propres à un produit (authentification IAM d'Aurora, endpoints différenciés, métriques aurora_%) ne reçoivent aucun traitement particulier : Calíope gère le serveur comme un membre standard de sa famille.
SQL Server se connecte à la version 2022 ou ultérieure, toujours chiffré. Un profil SQL Server synchronisé vers un appareil qui a encore Calíope 1.4 s'y affiche comme MariaDB, car cette version ne connaît pas la famille ; l'ouvrir là-bas ne fonctionnera pas tant que cet appareil n'est pas mis à jour.
Mots-clés : famille, produit, aurora, amazon aurora, aws, rds, mysql, mariadb, postgresql, mongodb, compatible, protocole, détecter, type de serveur
Calíope vous avertit lorsque le tunnel SSH tombe et lorsqu'il se rétablit automatiquement.
Où le trouver : Calíope › Préférences › Notifications
Lorsqu'un profil a le Tunnel SSH activé, Calíope envoie des notifications locales à deux moments :
- Tunnel perdu — lors de la détection d'un échec de connexion, avant la tentative de reconnexion.
- Tunnel rétabli — si la reconnexion automatique (option Reconnexion automatique du profil) restaure le tunnel avec succès.
Activer ou désactiver :
Allez dans Préférences › Notifications et utilisez le bouton Tunnel SSH perdu / rétabli.
Si la reconnexion automatique échoue, aucune notification de rétablissement n'est envoyée ; la chute a déjà été notifiée. Le délai de récupération entre notifications pour le même hôte est de 60 s.