Il dizionario dei dati

Traduzione automatica provvisoria, non revisionata. In caso di dubbio, consultare la versione inglese, che fa fede.

Il formato FIT definisce ben più di cento tipi di messaggio. Cordelia memorizza ognuno di quelli che riconosce in una tabella dedicata.

La gerarchia principale

La maggior parte di ciò che interessa in un file di attività si annida così:

Activity (Attività), il record di livello superiore per una singola attività registrata, come una corsa o un'uscita in bici.
Session (Sessione), un segmento sportivo all'interno di un'attività. La maggior parte delle attività ha esattamente una sessione, ma le attività multisport (come un triathlon) ne hanno diverse.
Lap (Giro), una suddivisione di una sessione, creata automaticamente dal dispositivo (ad esempio uno per chilometro) oppure manualmente premendo il pulsante giro.
Record, i singoli punti dati registrati a intervalli regolari durante una sessione: marca temporale, posizione, frequenza cardiaca, passo e valori simili. Di solito è la tabella più grande per numero di righe.

Tabelle di supporto comuni

Device Info (Informazioni sul dispositivo), dettagli sul dispositivo di registrazione e su eventuali sensori collegati.
Event (Evento), eventi puntuali durante un'attività, come avvio, arresto o pausa.

Oltre a queste, Cordelia riconosce molti altri tipi di messaggio specializzati: misuratori di potenza, variabilità della frequenza cardiaca, metriche per sport.

Lo schema in SQL

Ogni tabella e indice che Cordelia crea, in un semplice file .sql di istruzioni CREATE TABLE, lo stesso schema che questa pagina e il riferimento completo dei campi descrivono a parole, in una forma che si può leggere in un editor di testo, confrontare con una versione successiva o eseguire direttamente su un database SQLite vuoto. Ogni file si apre con un'intestazione di commenti che registra le build esatte di Cordelia e Kent da cui è stato esportato, così un estratto resta sempre tracciabile. Vengono prodotti con kent sqldump --schema-only. Quel comando si chiamava kent dump finché Kent 1.3.0 non lo ha rinominato, per questo l’intestazione di v01 dice kent dump e quella di v02 dice kent sqldump. Ciascuna nomina il comando che ha davvero scritto il file, e un estratto pubblicato non viene mai modificato dopo la firma.

L'estratto contiene solo la struttura (nessuna riga. In particolare better_labels_definitions e better_labels_lookup vengono create vuote: per avere le tabelle di etichette già popolate, conviene scaricare uno dei database sportivi da Database di Esempio di Cordelia) il solo database della corsa contiene 16.866 righe di ricerca. Vedere The better_labels Lookup Tables (solo in inglese) per capire a cosa servono queste due tabelle.

Download

Schema	`user_version`	Esportato da	Pubblicato	File
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

Ogni versione dello schema mai pubblicata resta in questo elenco in modo permanente. A differenza del download di un'applicazione, uno schema vecchio non è qualcosa che si possa installare per errore, e per chi possiede un database scritto da una versione precedente di Cordelia è l'unica descrizione accurata di ciò che contiene.

Quale schema usa il mio database?

Cordelia marca ogni database che crea con la propria versione di schema, memorizzata nel pragma user_version di SQLite. kent info la riporta, insieme alla versione che la build di Kent stessa si aspetta. In alternativa, qualsiasi client SQLite può leggerla: