Cette page décrit Calíope 1.5, la version que nous construisons en ce moment. La 1.4 est terminée et en cours d'examen par Apple, et la boutique propose aujourd'hui la 1.3 sur le Mac et la 1.2 sur iPad. 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, le type de serveur (MySQL, MariaDB, Aurora, PostgreSQL ou MongoDB), l'hôte, le port, le nom d'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. Les modifications sont enregistrées automatiquement lors de la connexion ou lorsque vous sélectionnez un autre profil.
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 MySQL/MariaDB via MySQLKit 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 le contexte de base de données de la session depuis l'Éditeur SQL.
Où le trouver : Éditeur SQL › Sélecteur de base de données
Utilisez le sélecteur de base de données dans la barre de l'Éditeur SQL pour changer le contexte actif sans vous reconnecter. Le changement équivaut à exécuter USE nom_bd et 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 MySQL 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 MySQL 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 (coin supérieur gauche sur macOS, barre d'onglets sur iPad).
2. Appuyez sur Ajouter un serveur.
3. Le Gestionnaire de connexions s'ouvre en tant que panneau flottant.
4. Sélectionnez un profil existant ou créez-en un nouveau et appuyez sur Connexion.
5. Le panneau se ferme automatiquement 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 MySQL 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.
Sur iPad : utilisez le sélecteur de fichiers système pour choisir les fichiers de certificat depuis votre stockage local ou iCloud Drive.
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 à un serveur.
Où le trouver : Panneau latéral › Formulaire profil › Exiger la biométrie
Calíope peut protéger un profil de connexion avec une authentification biométrique. Lorsqu'elle est active, l'application demande Touch ID (macOS / iPad) ou Face ID (iPad avec Face ID) avant d'autoriser la connexion.
Activer sur macOS :
- Dans le formulaire du profil, activez Exiger la biométrie dans la section Options du serveur.
- Vous pouvez également l'activer globalement depuis Préférences › Connexions › Biométrie.
Activer sur iPad :
- Dans le formulaire du profil, activez Exiger la biométrie dans la section Options.
- Également disponible de façon globale dans Préférences › Général › Exiger la biométrie.
Si l'appareil n'a pas de biométrie disponible ou si les autorisations sont révoquées, l'authentification échoue et la connexion n'aboutit pas. Vérifiez les autorisations dans Réglages système › Confidentialité et sécurité › Touch ID (macOS) 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.
Comment utiliser Calíope avec des clusters Amazon Aurora (édition compatible MySQL) et quelles fonctionnalités sont disponibles.
Où le trouver : Panneau latéral › Gestionnaire de connexions
Amazon Aurora (édition compatible MySQL) utilise le même protocole que MySQL ; Calíope se connecte donc avec le même moteur, sans configuration particulière.
Créer le profil
1. Dans Type, choisissez Aurora.
2. Dans Hôte, collez l'endpoint de votre cluster (par exemple mon-cluster.cluster-xxxx.us-east-1.rds.amazonaws.com) : utilisez l'endpoint d'écriture pour le travail normal, ou un endpoint de lecture si vous ne faites que des requêtes.
3. Laissez le Port sur 3306.
4. Renseignez utilisateur et mot de passe comme pour n'importe quel serveur MySQL.
Ce que vous obtenez
Avec Aurora, Calíope offre les mêmes fonctionnalités qu'avec MySQL : éditeur SQL, explorateur de schéma, diagrammes ER, sauvegardes et surveillance. Un avis dans le formulaire rappelle que les capacités disponibles sont celles compatibles avec MySQL ; vous pouvez le masquer avec Ne plus afficher.
Sécurité
Aurora exige généralement TLS : activez SSL/TLS dans le profil et, si votre réseau l'exige, combinez-le avec un tunnel SSH vers un hôte à l'intérieur du VPC.
Remarque
Les fonctionnalités propres à Aurora (authentification IAM, endpoints de cluster distincts, métriques aurora_%) ne sont pas gérées de façon spéciale : Calíope traite le cluster comme un serveur MySQL standard.
Mots-clés : aurora, amazon aurora, aws, rds, mysql, compatible, endpoint, cluster, moteur, type de serveur, protocole mysql
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.