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.

Journal des requêtes

Afficher le journal des requêtes

Historique complet des requêtes exécutées avec leur durée et leur statut.

Où le trouver : Espace de travail › Outils › Journal SQL

Ouvrez le Journal des requêtes depuis la barre de navigation de l'espace de travail. Il affiche toutes les requêtes de la session actuelle et des sessions passées, avec leur identifiant de session, leur horodatage, leur temps d'exécution et leur statut (OK/Erreur).

Mots-clés : journal, historique, requêtes, log, query log, enregistrement

Filtrer par session

Afficher uniquement les requêtes d'une session spécifique.

Où le trouver : Journal des requêtes › Sélecteur de session

Le sélecteur Session dans la barre du Journal permet de filtrer par session de connexion. À chaque connexion au serveur, un identifiant de session unique est généré. Choisissez Toutes les sessions pour voir l'historique complet ou sélectionnez une session spécifique.

Mots-clés : session, filtrer, ID, session de connexion, filtre

Rechercher dans le journal

Filtrer les entrées du journal par texte de requête.

Où le trouver : Journal des requêtes › Recherche

Saisissez au moins 2 caractères dans le champ de recherche de la barre du Journal. Le filtre textuel est cumulatif avec le filtre de session : les deux s'appliquent simultanément.

Mots-clés : rechercher, search, filtrer, texte, requête, trouver

Filtrer par connexion

Afficher uniquement les requêtes d'un profil de connexion spécifique.

Où le trouver : Journal des requêtes › Sélecteur de connexion

Le deuxième sélecteur dans la barre du Journal filtre les entrées par profil de connexion. Choisissez le nom du serveur ou du profil dans la liste déroulante pour voir uniquement les requêtes exécutées dans ce contexte. Sélectionnez Toutes les connexions pour voir l'historique complet.

Mots-clés : connexion, filtrer, profil, serveur, filtre connexion

Filtrer par résultat

Afficher uniquement les requêtes réussies ou celles ayant généré une erreur.

Où le trouver : Journal des requêtes › Sélecteur OK / Erreur

Le troisième sélecteur dans la barre du Journal filtre par statut d'exécution : Tous, OK (uniquement les requêtes réussies) ou Erreur (uniquement celles qui ont échoué). Combinez-le avec le filtre de session et la recherche textuelle pour cibler rapidement les entrées pertinentes.

Mots-clés : erreur, ok, statut, filtrer résultat, succès, échec

Actualiser manuellement le journal

Recharger les entrées du journal depuis le stockage local.

Où le trouver : Journal des requêtes › Bouton de rechargement

Appuyez sur le bouton de rechargement (icône de flèche circulaire) dans la barre du Journal pour forcer une actualisation manuelle. Utile lorsque le journal ne reflète pas les requêtes exécutées dans un autre onglet ou lors d'une session récente.

Mots-clés : actualiser, recharger, refresh, journal, manuel

Copier le résultat depuis le journal

Copier le résultat d'une requête enregistrée dans le presse-papiers.

Où le trouver : Journal des requêtes › clic droit › Copier le résultat

Ouvrez le menu contextuel de n'importe quelle entrée du Journal des requêtes — clic droit sur macOS, appui long sur iPad — et sélectionnez Copier le résultat. Le résultat (texte de la réponse ou message d'erreur) est copié dans le presse-papiers sans avoir à réexécuter la requête.

Mots-clés : copier, résultat, presse-papiers, clipboard, journal, menu contextuel

Purger le journal persistant

Supprimer définitivement toutes les entrées du journal SQLite.

Où le trouver : Journal des requêtes › Purger / Nettoyer

Le journal persistant est stocké dans une base de données SQLite locale (query_log.db) dans le répertoire de support de l'application. Pour tout supprimer, utilisez l'une de ces deux méthodes :

- Bouton rouge « Effacer » dans la barre de filtres supérieure.
- Bouton « Purger » dans la barre d'informations du fichier, en bas de la vue.

Dans les deux cas, Calíope affiche une boîte de dialogue de confirmation avant de supprimer. L'opération supprime toutes les lignes de la table executedqueries ; elle n'affecte pas l'historique de session en mémoire ni le journal d'audit DDL.

Cette action ne peut pas être annulée.

Mots-clés : effacer, purger, supprimer, clear, purge, journal, sqlite, vider

Chemin et taille du fichier journal

Consulter l'emplacement du fichier query_log.db et l'espace qu'il occupe.

Où le trouver : Journal des requêtes › Barre de fichier (pied)

La barre inférieure du Journal persistant affiche en permanence :

- Chemin complet du fichier query_log.db (répertoire de support de l'app).
- Taille en B, Ko, Mo ou Go selon le cas, mise à jour à chaque rechargement du journal.

Sur macOS — appuyez sur Afficher dans le Finder pour ouvrir le Finder avec le fichier sélectionné. Vous pouvez ensuite effectuer une sauvegarde manuelle ou le déplacer.

Sur iPad — appuyez sur Copier le chemin pour copier le chemin dans le presse-papiers.

Le chemin habituel sur macOS est :
~/Library/Application Support/Caliope/query_log.db

Mots-clés : chemin, path, taille, size, finder, query_log.db, fichier, emplacement, mo, go

Synchroniser le journal avec iCloud

Partager l'historique des requêtes entre Mac, iPad et iPhone via iCloud.

Où le trouver : Journal des requêtes › Bouton de synchronisation iCloud

L'icône de nuage dans le coin supérieur droit du Journal des requêtes contrôle la synchronisation avec iCloud CloudKit. Cette fonctionnalité est désactivée par défaut et est entièrement optionnelle.

Activer la synchronisation

Appuyez sur l'icône de nuage (contour gris) pour l'activer. Calíope vous demandera :
- Téléverser l'historique existant — téléverse toutes les entrées locales actuelles vers iCloud.
- Nouvelles entrées seulement — commence à synchroniser à partir de maintenant sans téléverser l'historique précédent.

À partir de ce moment, chaque requête exécutée est enregistrée simultanément dans la base de données locale et dans iCloud. Le champ résultat est stocké avec un maximum de 500 caractères.

Désactiver la synchronisation

Appuyez sur l'icône de nuage plein (bleu) pour la désactiver. Calíope vous demandera :
- Télécharger l'historique depuis iCloud — télécharge toutes les entrées iCloud vers l'appareil actuel.
- Non, juste désactiver — désactive la sync sans toucher aux données locales.

Indicateurs d'état

IcôneSignification
Nuage gris (contour)Sync désactivée
Nuage bleu pleinSync active, à jour
Indicateur de chargementSynchronisation en cours
Nuage rouge barréErreur de synchronisation (survolez pour voir le détail)

Rétention

La même politique de rétention configurée pour le journal local (90 jours par défaut) s'applique automatiquement aux enregistrements iCloud une fois par jour. Les deux stockages maintiennent ainsi le même horizon temporel.

Confidentialité

Les données sont stockées dans votre compte iCloud personnel (base de données privée CloudKit), invisible pour les autres utilisateurs et pour Apple.

Mots-clés : icloud, sync, synchroniser, cloudkit, nuage, historique, partager, ipad, mac

Résoudre les erreurs de synchronisation iCloud

Que faire lorsque l'icône de nuage apparaît en rouge.

Où le trouver : Journal des requêtes › Bouton nuage rouge

Lorsque l'icône de synchronisation apparaît barrée en rouge, appuyez dessus pour voir le détail de l'erreur et les options disponibles :

- Réessayer — tente de nouveau la synchronisation. À utiliser si l'erreur était temporaire (pas de réseau, iCloud indisponible).
- Désactiver la sync — désactive la synchronisation sans télécharger de données. L'historique local n'est pas modifié.

Causes fréquentes et solutions :

ErreurCauseSolution
« Vous n'êtes pas connecté à iCloud »Le compte iCloud n'est pas actifOuvrez Réglages Système → Compte Apple
« iCloud temporairement indisponible »Serveurs Apple en panne ou réseau sans couvertureAttendez quelques minutes et appuyez sur Réessayer
« Restrictions sur le compte »Contrôle parental ou MDM bloquant CloudKitContactez l'administrateur de votre appareil
« Impossible de vérifier l'état »Pas de connexion Internet au démarrageVérifiez le réseau et appuyez sur Réessayer

Remarque : L'état du compte iCloud est vérifié automatiquement à l'ouverture de l'app. Si le problème se résout (par ex. vous vous connectez à Internet), l'icône reviendra au bleu après l'exécution de la prochaine requête.

Mots-clés : erreur, icloud, sync, rouge, réessayer, indisponible, compte, résoudre

Notification d'échec de synchro iCloud

Calíope envoie une notification lorsque la synchronisation iCloud du journal échoue silencieusement.

Où le trouver : Calíope › Préférences › Notifications

Si la synchronisation iCloud de l'historique des requêtes échoue (pas de connexion, quota saturé, compte indisponible), Calíope peut vous alerter par une notification locale.

Scénarios couverts :
- Pas de connexion Internet au moment de la synchronisation.
- Quota iCloud épuisé — la notification utilise un message spécifique indiquant que le stockage est plein.
- Compte iCloud temporairement indisponible.

Activer ou désactiver :
Allez dans Préférences › Notifications et utilisez le bouton Échec de synchro iCloud. Ce bouton n'apparaît que si la synchronisation iCloud du journal est activée dans les Préférences.

Le délai entre les notifications est de 15 minutes pour éviter le spam (la sync est vérifiée à chaque requête exécutée).

Mots-clés : notification, icloud, sync, échec, quota, hors ligne, alerte