Listar os arquivos importados com files

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 kent files lista os arquivos .FIT registrados em um banco de dados, uma linha por arquivo que já tenha sido importado para ele, na ordem em que foram importados.

Ele é somente leitura e nunca toca nos próprios arquivos .FIT. Lê apenas o que o banco de dados registrou sobre eles, o que significa que funciona mesmo quando os arquivos originais já sumiram da máquina há muito tempo.

Sinopse

kent files <dbfilename>

O que ele mostra

$ kent files mydata.sqlite
Database:  mydata.sqlite

#  Imported              Created               Path
1  2026-08-12T09:14:03Z  2026-08-11T17:22:41Z  /home/user/rides/morning.fit  (Forerunner 965)
2  2026-08-14T20:41:55Z  2026-08-14T06:02:10Z  /home/user/rides/evening.fit
3  2026-08-15T11:00:00Z  -                     /home/user/rides/hike.fit

Coluna	O que é
`#`	O número do arquivo neste banco de dados. Cada atividade, sessão e registro do banco aponta para um deles, então é também o número a citar quando você quiser identificar um arquivo. É atribuído na ordem de importação.
`Imported`	Quando o Cordelia importou o arquivo. Sempre presente.
`Created`	Quando o próprio dispositivo gravou o arquivo. Mostrado como `-` quando o arquivo não trazia essa informação. Nem todo dispositivo a registra.
`Path`	O arquivo `.FIT` de onde ele foi importado. É onde o arquivo estava no momento da importação; isso não é verificado, e ele pode não estar mais lá.

Um nome de dispositivo entre parênteses após o caminho aparece apenas quando o arquivo trazia um. A maioria não traz, e um par de parênteses vazio em cada linha seria ruído.

As larguras das colunas acompanham o valor mais longo realmente presente, de modo que um banco de caminhos curtos não fica com uma coluna larga e quase em branco.

Um banco de dados sem arquivos

Um banco de dados que foi criado mas nunca recebeu importação imprime uma constatação simples e tem sucesso. Nenhum arquivo é uma resposta, não uma falha, e o código de saída é 0:

$ kent createdb mydata.sqlite
$ kent files mydata.sqlite
Database:  mydata.sqlite

No files recorded.
$ echo $?
0

Em um script, isso importa: teste o código de saída para descobrir se o Kent conseguiu ler o banco de dados, não se ele encontrou alguma coisa.

Um caminho que não existe é relatado como ausente e não é criado:

$ kent files nope.sqlite
kent files: nope.sqlite does not exist
$ echo $?
1

Um banco de dados mais antigo é recusado

O files recusa um banco de dados gravado por um Cordelia mais antigo do que esta compilação espera, do mesmo modo que info e details. Ele lê colunas nomeadas específicas, então um banco antigo que nunca as teve falharia de outro modo com um erro bruto do SQLite em vez de uma explicação.

kent sqldump e kent archive são os dois comandos que leem um banco assim mesmo assim. Veja Mensagens de erro e códigos de saída.

O que ele não é

O files lista os arquivos que foram importados. Não lista as atividades dentro deles e não mostra nenhum dos dados registrados. Para contagens do que um banco de dados contém, veja kent info e kent details; para ler os dados em si, veja kent archive ou Visualizar os dados importados.

Veja também Mensagens de erro e códigos de saída e Importar arquivos .FIT.