Le dictionnaire de données

Traduction automatique provisoire, non révisée. En cas de doute, consultez la version anglaise, qui fait foi.

Le format FIT définit bien plus d’une centaine de types de message. Cordelia stocke chacun de ceux qu’il reconnaît dans sa propre table.

La hiérarchie centrale

L'essentiel de ce qui vous intéresse dans un fichier d'activité s'imbrique ainsi :

Activity (Activité), l'enregistrement de niveau supérieur d'une seule activité enregistrée, comme une course ou une sortie à vélo.
Session (Séance), un segment sportif au sein d'une activité. La plupart des activités n'ont qu'une seule séance, mais les activités multisports (comme un triathlon) en ont plusieurs.
Lap (Tour), une subdivision d'une séance, créée soit automatiquement par l'appareil (par exemple, un par kilomètre), soit manuellement en appuyant sur le bouton de tour.
Record (Enregistrement), les points de données individuels enregistrés à intervalles réguliers pendant une séance : horodatage, position, fréquence cardiaque, allure et valeurs similaires. C'est généralement la table la plus volumineuse en nombre de lignes.

Tables de soutien courantes

Device Info (Info appareil), détails sur l'appareil d'enregistrement et tout capteur connecté.
Event (Événement), occurrences ponctuelles pendant une activité, comme démarrer, arrêter ou mettre en pause.

Au-delà, Cordelia reconnaît bien d’autres types de message spécialisés : capteurs de puissance, variabilité de la fréquence cardiaque, métriques propres à un sport.

Le schéma en SQL

Chaque table et chaque index que crée Cordelia, dans un simple fichier .sql d'instructions CREATE TABLE, le même schéma que cette page et la référence complète des champs décrivent en prose, sous une forme que vous pouvez lire dans un éditeur de texte, comparer à une version ultérieure, ou exécuter directement sur une base SQLite vide. Chaque fichier commence par un en-tête de commentaires indiquant les versions exactes de Cordelia et de Kent depuis lesquelles il a été exporté, de sorte qu'un fichier reste toujours traçable. Ils sont produits avec kent sqldump --schema-only. Cette commande s’appelait kent dump jusqu’à ce que Kent 1.3.0 la renomme, d’où l’en-tête kent dump pour v01 et kent sqldump pour v02. Chacun nomme la commande qui a réellement écrit le fichier, et un fichier publié n’est jamais modifié après signature.

Le fichier ne contient que la structure, aucune ligne. En particulier, better_labels_definitions et better_labels_lookup sont créées vides ; si vous voulez les tables de libellés déjà remplies, prenez plutôt une des bases sportives de Bases de Données d'Exemple Cordelia : celle de course à pied contient à elle seule 16 866 lignes de correspondance. Voir The better_labels Lookup Tables (en anglais uniquement) pour le rôle de ces deux tables.

Téléchargements

Schéma	`user_version`	Exporté depuis	Publié	Fichiers
v01	1	Cordelia `1.2.2-a5d308f4e3` Kent `1.2.1-8b9407de98`	2026-08-31	SQL (53,7 KiB) · SHA-256 · GPG
v02	2	Cordelia `1.3.0-d947b6b8b9` Kent `1.3.1-98e99ab624`	2026-09-03	SQL (53,7 KiB) · SHA-256 · GPG

Toutes les versions du schéma publiées restent définitivement dans cette liste. Contrairement au téléchargement d'une application, un ancien schéma n'est pas quelque chose que l'on peut installer par erreur, et si vous détenez une base écrite par une version antérieure de Cordelia, c'est la seule description exacte de son contenu.

Quel schéma ma base de données utilise-t-elle ?

Cordelia inscrit dans chaque base qu'elle crée sa version de schéma, stockée dans le pragma user_version de SQLite. kent info l'affiche, ainsi que la version attendue par la compilation de Kent elle-même. À défaut, n'importe quel client SQLite peut la lire :