Premiers pas

Vue d'ensemble de l'application et de son flux de travail.

Calíope est un client natif pour MySQL, MariaDB, Amazon Aurora et PostgreSQL disponible sur macOS, iPad et iPhone. Le flux de travail principal s'articule autour de deux écrans : le Gestionnaire de connexions, où les profils de serveurs sont administrés, et l'Espace de travail, qui s'ouvre une fois la connexion établie.

L'Espace de travail comprend un panneau latéral avec l'arbre des schémas, une barre d'onglets pour ouvrir plusieurs outils simultanément, et une barre d'accès rapide à tous les outils disponibles.

Mots-clés : démarrage, présentation, introduction, qu'est-ce que, overview, bienvenue

Un seul fichier lance douze serveurs de test sur votre Mac, déjà remplis.

Si vous n'avez aucun serveur sous la main, ou si vous voulez voir ce dont Calíope est capable avant de le brancher sur l'un des vôtres, vous pouvez lancer sur votre Mac l'environnement de test sur lequel l'application est développée. C'est un seul fichier, et il ne demande rien d'autre que Docker.

→ Télécharger caliope-testbed.command

Ce qu'il vous faut. macOS 12 ou plus récent, Docker Desktop — gratuit pour un usage personnel, sur docker.com — et environ 2 Go de disque et de mémoire libres.

Comment le démarrer. Le plus propre est de coller ces quatre lignes dans le Terminal :

cd ~/Downloads
curl -fLO https://caliope.org/caliope-testbed.command
chmod +x caliope-testbed.command
./caliope-testbed.command

Si vous préférez le télécharger avec le navigateur, il faut deux choses de plus, et dans cet ordre : le rendre exécutable (chmod +x sur le fichier téléchargé) et l'ouvrir la première fois par clic droit › Ouvrir plutôt qu'un double clic, car macOS met en quarantaine ce qu'un navigateur télécharge. Avec curl, ni l'un ni l'autre.

La première fois, il met quelques minutes à télécharger les images, et il dit où il en est pendant qu'il travaille. À la fin, il imprime un seul rapport avec les adresses, les ports et les identifiants.

Ce qu'il lance. Douze serveurs, choisis pour qu'aucun outil de Calíope ne reste sans rien à montrer :

Avec un bastion SSH et des générateurs de charge continue : le Tableau de bord, le journal des requêtes lentes, la liste des processus et le moniteur de réplication ont ainsi du vrai trafic à montrer.

Les profils ne s'écrivent pas à la main. Chaque exécution laisse un fichier caliope-testbed-connections.json à côté du lanceur, avec les douze nœuds en un seul groupe. Dans Calíope : Réglages › Connexions › Importer. L'import fusionne : rien de ce que vous avez déjà n'est supprimé. L'utilisateur est caliope et le mot de passe caliopepass. Les deux profils par tunnel demandent leur mot de passe SSH (tunnel123) la première fois, car les secrets SSH ne vivent que dans le Trousseau.

Depuis l'iPad et l'iPhone aussi. Chaque profil porte l'adresse réseau du Mac comme adresse de secours : le même fichier fonctionne donc sur les trois appareils sans rien modifier — avec le Mac allumé, le banc d'essai en marche et les deux sur le même réseau.

Les quatre commandes.

Attention à --fresh : c'est destructeur, et cela va au-delà de Calíope. Il arrête tous les conteneurs Docker de votre Mac et supprime les images, volumes et caches que personne n'utilise, y compris ceux de vos autres projets. Il le dit et demande confirmation avant quoi que ce soit. En échange, c'est la seule exécution qui propose de télécharger les trois jeux de données d'exemple, un par moteur : Sakila pour MySQL et MariaDB, Pagila pour PostgreSQL et l'échantillon Atlas pour MongoDB. Chacun est demandé séparément.

Ce n'est pas un serveur pour travailler. Les mots de passe sont publics et écrits dans le fichier lui-même, rien n'est chiffré et tout écoute sur votre machine. C'est un banc d'essai : pour apprendre, pour essayer un outil avant de l'utiliser sur vos données, et pour qu'un rapport de bogue puisse être reproduit.

Mots-clés : docker, test, banc d'essai, exemple, sans serveur, démo, s'entraîner, sakila

Créez un profil et établissez votre première connexion à un serveur.

Où le trouver : Gestionnaire de connexions › Bouton +

Dans le Gestionnaire de connexions, appuyez sur le bouton + dans la barre latérale pour créer un nouveau profil. Renseignez l'hôte, le port (3306 par défaut), le nom d'utilisateur et le mot de passe. Appuyez sur Tester la connexion pour vérifier les informations avant de sauvegarder.

Une fois validés, appuyez sur Connexion pour ouvrir l'Espace de travail. Le profil est sauvegardé et sera disponible dans la liste pour les connexions futures.

Mots-clés : première fois, nouvelle connexion, profil, hôte, port, connexion

Comment utiliser la barre latérale Outils, les onglets, le sélecteur de serveur et la barre d'état.

L'Espace de travail comporte trois zones : la barre latérale Outils à gauche, la barre d'onglets avec les outils ouverts, et la barre d'état en bas.

Pour ouvrir un outil, cliquez sur sa ligne dans la barre latérale. Chacun s'ouvre dans son propre onglet ; vous pouvez en garder plusieurs ouverts et passer de l'un à l'autre avec ⌘] et ⌘[. Les lignes sont regroupées par thème, et l'ordre comme les groupes se règlent depuis le bouton ⋮≡ de la barre latérale (voir Personnaliser la barre principale). Chaque groupe se replie en cliquant sur son en-tête, et le champ en haut de la barre latérale filtre les outils par leur nom (voir Filtrer et replier la barre latérale).

Sélecteur de serveur : le menu portant le nom du serveur actif se trouve en haut à gauche (macOS) ou à gauche de la barre d'onglets (iPad). Vous pouvez y changer de session, ajouter un autre serveur ou vous déconnecter. Calíope accepte plusieurs connexions actives simultanément.

Masquer la barre latérale : le bouton de la barre de titre la replie et laisse toute la largeur à l'outil actif.

L'arbre de schéma n'est pas ici : il vit dans l'Éditeur SQL, le seul endroit où il sert.

Hors connexion : l'Espace de travail sans serveur affiche une barre d'accès rapide avec ce qui ne demande pas de connexion — Éditeur SQL, Extraits, Éditeur SQLite, Aperçu de fichiers, Erreurs et Rapports. Le chevron à son extrémité droite la replie.

Sur iPhone et en fenêtre étroite : les outils vivent dans une barre inférieure avec les quatre premiers de votre ordre et un bouton Plus pour le reste. Lesquels sont ces quatre, c'est vous qui le décidez en réordonnant la barre latérale.

Mots-clés : espace de travail, barre latérale, outils, onglets, navigation, sélecteur de serveur, barre d'état, hors connexion

La liste de la barre latérale dépend de la connexion, pas d'un réglage que vous auriez changé.

Le navigateur d'outils n'affiche pas toujours la même liste : il affiche ce que cette session sait faire. À la connexion, Calíope détermine ce dont cette connexion est capable et masque le reste. Ce que vous ne voyez pas n'est ni cassé ni désactivé : il n'est pas proposé.

Le masquage est délibéré. Un outil qui s'ouvre juste pour dire « pas ici » vous a déjà fait perdre le voyage, et une ligne grisée invite à chercher l'interrupteur qui l'allume — et il n'existe pas.

À cause du type de base de données. Un serveur relationnel et un serveur de documents ne se ressemblent pas : une session de documents n'a ni éditeur SQL ni diagramme entité-association, et une session relationnelle n'a pas d'explorateur de collections. Cela ne change jamais, et ce n'est un manque ni pour l'un ni pour l'autre.

À cause de ce que sait faire cette connexion. Deux serveurs relationnels ne proposent pas non plus exactement la même chose. Parfois le moteur n'a pas ce concept, et l'outil n'apparaîtra alors jamais face à ce serveur, puisqu'il n'y aurait rien à montrer ; parfois Calíope ne l'a pas encore écrit pour ce moteur, et il apparaîtra dans une version ultérieure. Les deux absences se ressemblent volontairement : ce qu'il vous faut savoir maintenant, c'est si l'outil sert, pas pourquoi il ne sert pas.

Hors connexion, le navigateur n'affiche que ce qui fonctionne sans serveur : l'Éditeur SQL, les Extraits, l'Éditeur SQLite, l'Aperçu de fichiers, les Erreurs et les Rapports — ces derniers à moitié, car sans serveur on peut les consulter, les modifier et les exporter, mais pas les exécuter.

Où cela se voit aussi. Le bouton Aller de cette aide peut pointer vers un outil que votre session ne propose pas : alors rien ne s'ouvre et la barre d'état le dit, avec son nom. C'est une réponse, pas une panne.

Et cette aide les contient tous. L'index ne change pas selon le serveur auquel vous êtes connecté : vous y trouverez donc des rubriques d'outils que votre session actuelle n'affiche pas. S'il vous en manque un, essayez d'ouvrir une session vers un autre serveur : la liste est recalculée à chaque connexion.

Mots-clés : outils, manquants, absents, navigateur, disponibilité, moteur, session, masqués, Aller

Repliez les groupes que vous n'utilisez pas et tapez dans le champ du haut pour trouver un outil par son nom.

La barre latérale Outils répartit par thème la vingtaine d'outils de Calíope. Deux choses la raccourcissent.

Replier un groupe : cliquez sur son en-tête. Le chevron pivote et les lignes du groupe disparaissent ; à côté du nom reste le nombre d'outils masqués, pour qu'aucun ne se perde sans laisser de trace. Cliquez à nouveau pour le déplier. Ce que vous repliez est conservé à la fermeture de l'app, et voyage vers votre autre Mac, iPad ou iPhone si la synchronisation iCloud est activée.

Filtrer : le champ du haut ne laisse que les outils qui correspondent à ce que vous tapez. Il cherche dans le nom de l'outil, dans son nom complet du catalogue et dans la phrase qui dit ce qu'il fait, ainsi que dans le nom de son groupe — taper le nom d'un groupe l'affiche donc en entier. Les accents n'ont pas d'importance : replication trouve Replicación.

Pendant que vous filtrez, tout groupe avec des correspondances est dessiné ouvert, même ceux que vous aviez repliés. Rien de ce que vous trouvez ne peut rester caché dans un groupe fermé. Vos groupes repliés ne sont pas touchés : videz le champ et tout revient exactement comme avant.

Appuyez sur Échap ou sur le × pour vider le champ. Le filtre n'est pas conservé à la fermeture de l'app : une barre latérale à moitié vide pour une raison dont vous ne vous souvenez pas est pire que retaper trois lettres.

Mots-clés : barre latérale, outils, filtrer, rechercher, groupes, replier, déplier

Ce qui fonctionne sans se connecter à un serveur, et ce qui ne fonctionne pas.

Calíope inclut un Espace de travail hors ligne accessible même lorsqu'aucun serveur n'est connecté. Il est utile pour rédiger des requêtes et organiser vos fragments sans nécessiter de connexion.

Comment y accéder :

Depuis le Gestionnaire de connexions, sans se connecter à aucun serveur. L'emplacement du bouton dépend de la place disponible : sur un écran large — le Mac et l'iPad — il est sur l'écran d'accueil, à côté de « Créer un profil » ; sur un écran étroit — l'iPhone, et l'iPad en fenêtre partagée — cet écran n'est pas dessiné, il se trouve donc dans la barre du bas, avec l'icône de terminal.

Outils disponibles en mode hors ligne :
- Éditeur SQL — rédigez et sauvegardez du SQL, utilisez l'historique et les extraits. Les requêtes ne peuvent pas être exécutées contre un serveur.
- Extraits — créez, modifiez et copiez vos extraits de code.
- Éditeur SQLite — ouvrez un fichier .sqlite du disque et travaillez-le entièrement : aucun serveur n'est nécessaire, car le fichier est la base.
- Aperçu de fichiers — consultez CSV, JSON, Markdown et le reste sans quitter l'app.
- Erreurs — le journal est local, et il faut pouvoir le lire justement quand on ne peut pas se connecter.
- Rapports — vous pouvez consulter, modifier et exporter les résultats déjà obtenus ; en exécuter un demande bien un serveur, et la vue le dit.

Bannière de mode hors ligne : une bande dorée en haut de l'espace de travail indique que vous êtes en mode hors ligne.

Pour vous connecter à un serveur depuis l'espace de travail hors ligne, appuyez sur le bouton Se connecter au serveur dans la barre d'outils ou dans la bannière supérieure. Le Gestionnaire de connexions s'ouvre en panneau flottant sans perdre le contenu de l'éditeur.

Mots-clés : hors ligne, mode hors ligne, sans serveur, éditeur hors ligne, espace de travail hors ligne, offline, sans connexion, fragments

Affiche le résultat, le temps d'exécution et la progression des opérations en cours.

La barre d'état apparaît en bas de l'Espace de travail et de l'éditeur SQL. Elle reflète l'état de la dernière opération exécutée.

Informations affichées :
- Message de résultat — texte descriptif de la dernière opération (lignes affectées, temps d'exécution, erreur).
- Progression — barre de progression ou animation de chargement pendant qu'une requête ou une tâche est en cours d'exécution.
- Pourcentage — pour les opérations longues (comme les sauvegardes ou les restaurations), affiche la progression numérique.

Copier le message :

macOS : faites un double-clic sur la zone de texte de la barre d'état pour copier le message complet dans le presse-papiers. Utile pour copier des messages d'erreur sans avoir à les sélectionner manuellement.

iPad : le même geste de double-tap copie le message.

La barre d'état est toujours visible et ne peut pas être masquée.

Mots-clés : barre d'état, status bar, progression, message, copier message, erreur, temps d'exécution, double-clic

Réorganisez et masquez les boutons des barres de l'éditeur et des résultats.

Où le trouver : Éditeur SQL › Personnaliser la barre

L'Éditeur SQL possède deux barres de boutons, personnalisables séparément :

- Barre de l'éditeur — au-dessus de la zone de texte : exécuter, formater, commenter, historique, panneau de schéma…
- Barre des résultats — au-dessus de la grille : exporter, graphique, profileur de colonnes, filtres…

Ouvrir le personnalisateur
Cliquez sur le bouton ⋮≡ (icône slider.horizontal.3) au début de la barre à régler.

Ce que vous pouvez faire
- Réorganiser — faites glisser chaque bouton où vous voulez.
- Masquer — décochez ceux que vous n'utilisez pas ; leurs actions restent accessibles par les menus et les raccourcis clavier.
- Réinitialiser — rétablit la disposition d'origine de cette barre.

Les deux barres défilent horizontalement : aucun bouton n'est hors de portée, même dans une fenêtre étroite.

Pour le lanceur d'outils de l'Espace de travail, voir Personnaliser la barre principale.

Mots-clés : barre de l'éditeur, barre des résultats, personnaliser, réorganiser, masquer, glisser, éditeur sql

Réorganisez les boutons de la barre principale de l'Espace de travail pour mettre vos outils favoris en premier.

Où le trouver : Espace de travail › Personnaliser la barre principale

La barre latérale de navigation (lanceur d'applications) organise les raccourcis vers tous les outils de l'Espace de travail en groupes logiques, pour un flux de travail optimisé :

1. Développement et requêtes — Éditeur SQL, Constructeur de requêtes, Fragments, Journal SQL et Éditeur SQLite.
2. Conception et structure — Catalogues, Diagramme ER, Diff de schémas et Migration d'objets.
3. Diagnostic et performance — Tableau de bord, Santé du serveur, Alertes SQL, Surveillance de la réplication et Visionneuse de binlogs.
4. Administration du serveur — Infos du serveur, Processus, Utilisateurs, Sauvegarde et Maintenance.
5. Assistant intelligent — Assistant IA.

Comment ouvrir le personnalisateur
- En haut de la barre latérale de navigation, vous trouverez le bouton de personnalisation ⋮≡ (icône slider.horizontal.3).
- Appuyez dessus pour ouvrir l'écran de personnalisation.

Ce que vous pouvez faire
Le personnalisateur offre un contrôle hiérarchique et entièrement dynamique, réparti en deux onglets :
- Onglet "Réorganiser les groupes" — glissez-déposez des sections entières pour changer l'ordre des catégories, les renommer ou même ajouter vos propres groupes personnalisés.
- Onglet "Réorganiser les éléments" — glissez-déposez les outils au sein de chaque groupe, ou appuyez sur Déplacer vers... pour déplacer dynamiquement n'importe quel outil vers une autre section.
- Réinitialiser — le bouton Réinitialiser rétablit l'ordre et les groupes par défaut d'une seule pression.

Persistance et autoréparation
Votre configuration est enregistrée de façon sûre dans UserDefaults (sous la clé caliope_sidebar_config_macos ou caliope_sidebar_config_ipad). Si Calíope ajoute un nouvel outil dans une mise à jour future, il s'insérera automatiquement dans son groupe par défaut sans perturber votre personnalisation.

Mots-clés : barre principale, quick access, nav strip, personnaliser, réorganiser, boutons, glisser, débordement

Travaillez avec plusieurs serveurs MySQL, MariaDB, Aurora ou PostgreSQL en même temps sans perdre le contexte de chacun.

Où le trouver : Serveur › Ajouter une session…

Calíope maintient des sessions indépendantes pour chaque profil de connexion que vous ouvrez. Chaque session dispose de ses propres onglets, de sa propre base de données active, de son propre historique de requêtes et de ses propres préférences de mise en page.

Ouvrir une nouvelle session
- macOS : menu Serveur › Ajouter une session… ou raccourci ⌘⌥N. Vous pouvez aussi cliquer sur Nouvelle session depuis le sélecteur de serveur dans le coin supérieur gauche.
- iPad : ouvrez le sélecteur de serveur (icône à gauche de la barre d'onglets) et appuyez sur Ajouter une session.

Basculer entre les sessions
- Utilisez le sélecteur de serveur depuis le coin supérieur gauche (macOS) ou depuis la barre d'onglets (iPad). Chaque session affiche le nom du profil, l'hôte et un point de couleur indiquant son état.
- macOS : raccourci ⌘⌥1…9 pour passer directement aux neuf premières sessions.

État par session
- Chaque session se souvient de la base de données active, des onglets ouverts et de l'historique de requêtes dans QueryLogger.
- Les connexions SSH et SSL sont établies une seule fois par session ; changer de session ne reconnecte pas.
- Le widget épinglé suit le profil marqué comme épinglé dans Préférences › Widget, quelle que soit la session au premier plan.

Fermer une session
- Fermez tous les onglets avec le × ou utilisez Serveur › Déconnecter. Calíope ferme le tunnel SSH s'il existe.
- Les mots de passe restent dans le Trousseau ; ils ne sont pas redemandés à la reconnexion sauf si le profil exige l'authentification biométrique.

Mots-clés : sessions, multi-session, plusieurs serveurs, simultanées, changer session, sélecteur serveur, ajouter session, gestionnaire de sessions, ⌘⌥N, déconnecter

Comment accéder à l'index complet de l'aide sur chaque plateforme.

Où le trouver : Aide › Aide de Calíope

L'aide de Calíope est disponible sous forme de fenêtre ou de panneau dédié avec un index, une recherche et une navigation par sections. Elle s'ouvre différemment selon la plateforme mais affiche le même contenu.

macOS : menu Aide › Aide de Calíope ou raccourci ⌘?. La fenêtre d'aide reste flottante et peut demeurer ouverte pendant que vous utilisez le reste de l'application.

iPad : menu Aide › Aide de Calíope ou raccourci ⌘? si un clavier externe est connecté. L'aide apparaît comme une feuille glissée ; fermez-la avec le bouton Fermer dans le coin supérieur droit ou faites glisser vers le bas.

Aide contextuelle (?) : chaque vue de l'application dispose d'un bouton ? dans sa barre supérieure qui ouvre directement le sujet correspondant. C'est le moyen le plus rapide lorsque vous savez déjà quel outil vous intéresse.

Sur le web : la même aide est publiée sur https://caliope.org/help/, dans les cinq langues. Depuis là, avec « J'ai installé Calíope » activé, chaque sujet a un bouton « Ouvrir dans Calíope » qui l'ouvre dans l'app ; le lien d'un sujet a la forme caliope://help/<identifiant>.

Mots-clés : aide, help, index, chercher sujet, menu aide, ⌘?, documentation, cmd?