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.
Ouvrez et modifiez des fichiers SQLite locaux sans serveur.
Où le trouver : Espace de travail › Outils › Éditeur SQLite
L'Éditeur SQLite est un outil autonome pour les fichiers locaux .sqlite/.db, à la manière de DB Browser for SQLite. Il comporte quatre sections : Structure, Données, Exécuter du SQL et Pragmas, et fonctionne même sans connexion à un serveur.
Calíope ouvre des bases SQLite non chiffrées (SQLCipher n'est pas pris en charge).
Mots-clés : sqlite, db, local, base de données, fichier
Ouvrez un fichier SQLite existant ou créez-en un nouveau.
Où le trouver : Archivo
Utilisez Ouvrir… pour choisir un fichier .sqlite/.db existant, ou Nouvelle base… pour en créer un vide. Les fichiers récents apparaissent sur l'écran d'accueil. Un badge Lecture seule s'affiche lorsqu'un fichier ne peut pas être modifié.
Parcourez tables, vues, index et déclencheurs, et créez-les.
La section Structure affiche l'arbre du schéma avec les colonnes et le DDL de chaque objet. Utilisez Nouveau pour créer des tables, index ou vues, Ajouter une colonne ou Renommer la table sur la table sélectionnée, et Supprimer pour supprimer un objet.
La section Données affiche les lignes d'une table page par page, avec le compteur et les flèches à droite de la barre. Triez en appuyant sur l'en-tête d'une colonne —appuyez à nouveau pour inverser l'ordre—, restreignez colonne par colonne avec Filtres, ou saisissez du texte dans le champ de recherche pour chercher dans toutes à la fois ; dans les deux cas le filtre s'applique en appuyant sur Entrée. Le sélecteur Table liste les tables du fichier, et elles ne sont pas toutes modifiables : sur une table WITHOUT ROWID, ou sur n'importe laquelle si le fichier a été ouvert en lecture seule, la barre indique que l'objet ne peut pas être modifié au lieu de proposer les boutons.
Modifier une cellule
macOS : double-clic dessus. iPad : un simple toucher.
La valeur se saisit dans la grille elle-même. Entrée valide, et quitter la cellule —en toucher une autre, ou perdre le focus— valide également ; Échap annule et laisse la valeur précédente (sur iPad, avec un clavier connecté).
L'éditeur avancé
Ce qui ne tient pas sur une ligne se saisit dans une feuille à part. Elle s'ouvre avec le bouton ⋯ de la cellule —macOS : au survol du pointeur ; iPad : sur les cellules de la ligne sélectionnée, que l'on marque en touchant son numéro— ou avec Éditeur avancé… dans le menu contextuel (clic droit sur macOS, appui prolongé sur iPad). Là, la même valeur s'écrit en texte, en JSON —avec un bouton qui le met en forme, et sans laisser appliquer un JSON invalide—, en hexadécimal, ou s'affiche comme image quand les octets en sont une —et cette image se zoome, de 100 % à 800 %, au pincement, à la molette ou avec les boutons du bas— ; et ces octets s'importent depuis un fichier et s'exportent vers un autre. Une cellule qui contient déjà des données binaires ouvre directement cette feuille, sans passer par le champ de la grille.
Laisser une cellule à NULL
Dans le menu contextuel de la cellule, Définir à NULL, sans rien ouvrir d'autre ; dans l'éditeur avancé, c'est aussi un interrupteur. Une cellule sans valeur s'affiche NULL en italique. Attention : effacer le contenu dans la grille et valider écrit la chaîne vide, qui n'est pas la même chose que NULL.
Ajouter et supprimer des lignes
Ajouter une ligne ouvre un formulaire avec une ligne par colonne, son type et si elle est obligatoire. Les colonnes que la table sait remplir seule —celles qui déclarent une valeur par défaut, et la clé primaire INTEGER— sont cochées d'emblée pour que le moteur les écrive : décochez la case si vous préférez saisir la valeur vous-même. Un champ laissé vide est enregistré comme NULL, et Insérer reste désactivé tant qu'une colonne obligatoire n'a pas de valeur —l'avertissement à côté indique laquelle—. À la validation, une seule instruction INSERT est émise, ne nommant que les colonnes qui portent une valeur. Pour supprimer, sélectionnez la ligne par son numéro et utilisez Supprimer la ligne, ou le menu contextuel de n'importe laquelle de ses cellules.
Rien de tout cela ne touche le fichier tant que vous n'appuyez pas sur Enregistrer les modifications : ce que vous modifiez reste dans une transaction en attente qu'Annuler les modifications défait entièrement.
Les modifications restent en attente jusqu'à leur enregistrement.
Les modifications sont regroupées dans une transaction en attente. Un point ambre indique des modifications non enregistrées. Utilisez Enregistrer les modifications pour valider ou Annuler les modifications pour les abandonner. La fermeture avec des modifications en attente demande confirmation.
Depuis Importer / Exporter, vous pouvez importer un fichier CSV dans une nouvelle table, exporter une table en CSV ou JSON, ou exporter toute la base en un vidage SQL (schéma et données).