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.
Chargez des données depuis un fichier CSV, JSON ou Excel (.xlsx) directement dans une table MySQL 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 vous permet d'insérer des lignes dans une table MySQL/MariaDB à partir d'un fichier externe, sans avoir à écrire du SQL manuellement.
Comment ouvrir l'assistant :
Dans l'Arbre de schéma, faites un clic droit sur une table et sélectionnez "Importer des données…". L'assistant d'importation s'ouvre avec cette table comme destination.
Étape 1 — Sélectionner le fichier :
- Appuyez sur Choisir un fichier et sélectionnez un fichier .csv, .json ou .xlsx.
- CSV — le séparateur de colonnes est détecté automatiquement (, ou ;).
- JSON — doit être un tableau d'objets ([{"col": valeur}, …]).
- Excel (.xlsx) — la première feuille du classeur est lue. Remarque : la prise en charge de .xlsx lit le fichier comme un ZIP et extrait la feuille XML ; aucune bibliothèque tierce n'est requise.
- Activez "La première ligne contient les en-têtes" si la première ligne définit les noms de colonnes (activé par défaut).
Étape 2 — Mapper les colonnes :
- Le tableau de mappage affiche chaque colonne du fichier à gauche et un sélecteur de colonne de destination à droite.
- Sélectionnez "— Ignorer —" pour toute colonne du fichier qui ne doit pas être importée.
- Calíope tente de détecter automatiquement les correspondances par nom.
Étape 3 — Options d'importation :
- Choisissez le mode d'insertion (voir le sujet Modes d'importation).
- Ajustez la taille du lot (par défaut : 500 lignes par INSERT). Des lots plus grands sont plus rapides mais consomment plus de mémoire sur le serveur.
- Appuyez sur Importer pour démarrer. Une barre de progression affiche l'avancement ligne par ligne.
- À la fin, le nombre de lignes insérées et les erreurs éventuelles sont affichés.
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 vous permet de contrôler exactement la façon dont les colonnes du fichier sont assignées aux colonnes de la table MySQL.
Fonctionnement du mappage :
- Chaque ligne du tableau de mappage représente une colonne du fichier source.
- Le sélecteur de droite affiche les colonnes disponibles dans la table de destination.
- Calíope tente de faire correspondre les noms automatiquement (sans tenir compte de la casse).
Ignorer des colonnes :
Sélectionnez "— Ignorer —" dans le sélecteur d'une colonne source pour l'exclure de l'importation. Cela est utile lorsque le fichier contient plus de colonnes que la table, ou lorsqu'une colonne ne doit pas être importée (p. ex., les ID auto-générés).
Colonnes sans correspondance automatique :
Si le fichier comporte une colonne dont le nom ne correspond à aucune colonne de la table, elle apparaîtra avec le sélecteur réglé sur "— Ignorer —" par défaut. Assignez-la manuellement si nécessaire.
Première ligne comme en-tête :
Si vous avez activé "La première ligne contient les en-têtes" à l'étape précédente, les noms des colonnes proviennent de cette première ligne et sont utilisés pour le mappage automatique. Si désactivé, les colonnes du fichier sont numérotées (Colonne 1, Colonne 2, …).
Recommandation :
Avant d'importer, vérifiez que toutes les colonnes NOT NULL sans valeur DEFAULT ont une colonne source assignée ; sinon, le serveur rejettera les lignes concernées.
Choisissez comment gérer les conflits de clé primaire ou unique lors de l'importation de données.
Où le trouver : Arbre des schémas › clic droit › Importer des données…
À l'Étape 3 de l'assistant d'importation, vous pouvez choisir comment le serveur doit se comporter lorsqu'une ligne importée entre en conflit avec une clé primaire ou unique existante.
INSERT (par défaut) :
Insère chaque ligne normalement. Si une ligne viole une contrainte de clé unique ou primaire, l'importation échoue sur cette ligne et le lot est annulé. Utilisez ce mode lorsque les données ne doivent pas contenir de doublons et que vous souhaitez détecter les conflits.
INSERT IGNORE :
Insère chaque ligne normalement, mais si une ligne viole une contrainte de clé, elle est ignorée silencieusement et l'importation continue avec la suivante. Les erreurs de clé dupliquée n'arrêtent pas l'importation. Utile pour les importations tolérantes aux doublons ou lorsqu'un sous-ensemble des données existe déjà dans la table.
REPLACE :
Si une ligne possède la même clé primaire ou unique qu'une ligne existante, elle supprime la ligne existante et insère la nouvelle. Équivaut à un DELETE suivi d'un INSERT. Utile pour mettre à jour des données existantes avec des versions plus récentes du fichier. Notez que REPLACE peut déclencher des triggers DELETE et réinitialise les colonnes avec DEFAULT si elles ne figurent pas dans le fichier.