O Dicionário de Dados

Tradução automática provisória, não revisada. Em caso de dúvida, consulte a versão em inglês, que é a versão de referência.

O formato FIT define bem mais de cem tipos de mensagem. A Cordelia guarda cada um que reconhece em sua própria tabela.

A hierarquia central

A maior parte do que interessa em um arquivo de atividade se organiza de forma aninhada assim:

Activity (Atividade), o registro de nível mais alto para uma única atividade gravada, como uma corrida ou um passeio de bicicleta.
Session (Sessão), um segmento esportivo dentro de uma atividade. A maioria das atividades tem exatamente uma sessão, mas atividades multiesportivas (como um triatlo) têm várias.
Lap (Volta), uma subdivisão de uma sessão, criada automaticamente pelo dispositivo (por exemplo, uma por quilômetro) ou manualmente ao pressionar o botão de volta.
Record (Registro), os pontos de dados individuais gravados em intervalos regulares durante uma sessão: carimbo de data/hora, posição, frequência cardíaca, ritmo e valores semelhantes. Geralmente é a tabela com o maior número de linhas.

Tabelas de suporte comuns

Device Info (Informações do Dispositivo), detalhes sobre o dispositivo de gravação e quaisquer sensores conectados.
Event (Evento), ocorrências pontuais durante uma atividade, como iniciar, parar ou pausar.

Além dessas, a Cordelia reconhece muitos outros tipos de mensagem especializados: medidores de potência, variabilidade da frequência cardíaca, métricas por esporte.

O esquema em SQL

Cada tabela e índice que o Cordelia cria, em um arquivo .sql simples de instruções CREATE TABLE, o mesmo esquema que esta página e a referência completa de campos descrevem em prosa, em um formato que você pode ler em um editor de texto, comparar com uma versão posterior ou executar diretamente em um banco de dados SQLite vazio. Cada arquivo começa com um cabeçalho de comentários registrando as compilações exatas do Cordelia e do Kent de que foi exportado, de modo que sempre seja possível rastrear sua origem. São produzidos com kent sqldump --schema-only. Esse comando se chamava kent dump até o Kent 1.3.0 renomeá-lo, por isso o cabeçalho de v01 diz kent dump e o de v02 diz kent sqldump. Cada um nomeia o comando que realmente escreveu o arquivo, e um despejo publicado nunca é editado depois de assinado.

O despejo contém apenas a estrutura (nenhuma linha. Em particular, better_labels_definitions e better_labels_lookup são criadas vazias; se você quiser as tabelas de rótulos já preenchidas, baixe um dos bancos de dados esportivos em Bancos de Dados de Exemplo do Cordelia) só o de corrida traz 16.866 linhas de consulta. Veja The better_labels Lookup Tables (apenas em inglês) para saber o que essas duas tabelas fazem.

Downloads

Esquema	`user_version`	Exportado de	Publicado	Arquivos
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

Toda versão do esquema já publicada permanece nesta lista em caráter permanente. Ao contrário do download de um aplicativo, um esquema antigo não é algo que se possa instalar por engano, e para quem tem um banco de dados escrito por uma versão mais antiga do Cordelia ele é a única descrição exata do que há dentro dele.

Qual esquema meu banco de dados usa?

O Cordelia carimba cada banco de dados que cria com sua versão de esquema, armazenada no pragma user_version do SQLite. kent info informa esse valor, junto com a versão que a própria compilação do Kent espera. Na falta dele, qualquer cliente SQLite consegue lê-lo: