Cette page décrit Calíope 1.7, la version que je construis en ce moment. La 1.6 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.
Chargez des données depuis un fichier CSV, JSON ou Excel (.xlsx) directement dans une table grâce à l'assistant d'importation en trois étapes.
Où le trouver : Arbre des schémas › clic droit › Importer des données…
L'assistant d'Importation de données insère des lignes dans une table à partir d'un fichier, sans écrire de SQL.
Comment l'ouvrir : dans l'arbre du schéma, ouvrez le menu contextuel d'une table et choisissez Importer des données…. Cette table devient la destination.
Étape 1 — Le fichier
- Appuyez sur Choisir un fichier et choisissez un .csv, .json ou .xlsx.
- CSV — séparé par des virgules, avec les guillemets de la RFC 4180 : un champ entre guillemets peut contenir des virgules et des sauts de ligne. La première ligne contient les noms des colonnes.
- JSON — un tableau d'objets ([{"col": valeur}, …]) ; les clés sont les noms des colonnes.
- Excel (.xlsx) — la première feuille est lue, et sa première ligne contient les noms des colonnes.
Étape 2 — Colonnes : chaque colonne du fichier est affectée à une colonne de la table, ou ignorée (voir Mapper les colonnes à l'importation). Si la première ligne d'un CSV ou d'une feuille ne contient pas de noms, désactivez La première ligne est l'en-tête : les colonnes sont numérotées et cette ligne est importée avec les autres.
Étape 3 — Importer
- Si le serveur admet plus d'une façon de traiter les doublons, choisissez le mode (voir Modes d'importation). S'il n'en admet qu'une, il n'y a rien à choisir et le sélecteur n'apparaît pas.
- Choisissez la taille de lot : 100, 500 —celle d'origine— ou 1000 lignes par instruction.
- Appuyez sur Importer. Une barre montre l'avancement lot par lot, et à la fin vous voyez combien de lignes sont entrées et les erreurs, s'il y en a.
Disponible sur macOS, iPad, iPhone et Apple Vision Pro.
Comment assigner les colonnes du fichier source aux colonnes de la table de destination à l'étape 2 de l'assistant d'importation.
Où le trouver : Arbre des schémas › clic droit › Importer des données…
L'étape 2 de l'assistant décide vers quelle colonne de la table va chaque colonne du fichier.
- Chaque ligne représente une colonne du fichier ; le sélecteur de droite propose les colonnes de la table de destination.
- Les colonnes qui portent exactement le nom d'une colonne de la table —majuscules comprises— arrivent déjà affectées. Les autres commencent sur Ignorer : affectez-les à la main si besoin.
- Ignorer laisse cette colonne de côté. Utile quand le fichier a plus de colonnes que la table, ou pour ne pas importer un identifiant que le serveur génère lui-même.
Avant d'importer, vérifiez que toute colonne NOT NULL sans valeur par défaut a une colonne du fichier affectée : sinon le serveur rejette ces lignes.
Quand une ligne heurte une clé primaire ou unique : échouer, l'ignorer ou remplacer celle qui existait. Ce qui est proposé dépend du serveur.
Où le trouver : Arbre des schémas › clic droit › Importer des données…
À l'étape 3 de l'assistant, vous choisissez ce qui se passe quand une ligne du fichier heurte une clé primaire ou unique existante. L'assistant ne propose que les modes que le serveur sait respecter.
Insérer (sur tous les serveurs ; là où Ignorer les doublons est proposé, l'assistant part de celui-là) : l'instruction du lot qui heurte échoue, et l'importation le dit. À utiliser quand il ne devrait pas y avoir de doublons et que vous voulez le savoir s'il y en a.
Ignorer les doublons : la ligne en conflit est écartée et le reste continue. Utile pour charger un fichier déjà en partie dans la table.
Remplacer les doublons : la ligne existante est supprimée et celle du fichier entre. Attention : cela déclenche les déclencheurs de suppression, et les colonnes absentes du fichier reprennent leur valeur par défaut.
MySQLMariaDBAurora
Les trois sont proposés.
PostgreSQL
Insérer et Ignorer les doublons sont proposés : pas de remplacement.
SQL ServerOracleClickHouse
Seulement Insérer, donc le sélecteur n'apparaît pas.
Disponible sur macOS, iPad, iPhone et Apple Vision Pro.