Importierte Dateien mit files auflisten

Vorläufige, ungeprüfte automatische Übersetzung. Im Zweifelsfall konsultieren Sie die englische Version, die als Referenzversion gilt.

kent files listet die in einer Datenbank verzeichneten .FIT-Dateien auf, eine Zeile pro Datei, die jemals in sie importiert wurde, in der Reihenfolge des Imports.

Der Befehl ist nur lesend und rührt die .FIT-Dateien selbst nie an. Er liest nur, was die Datenbank über sie festgehalten hat, und funktioniert daher auch dann, wenn die Originaldateien längst nicht mehr auf dem Rechner sind.

Übersicht

kent files <dbfilename>

Was er zeigt

$ 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

Spalte	Was sie bedeutet
`#`	Die Nummer der Datei in dieser Datenbank. Jede Aktivität, Sitzung und jeder Datensatz der Datenbank verweist auf eine davon, also ist es auch die Nummer, die man nennt, wenn man eine Datei identifizieren will. Sie wird in Importreihenfolge vergeben.
`Imported`	Wann Cordelia die Datei importiert hat. Immer vorhanden.
`Created`	Wann das Gerät selbst die Datei geschrieben hat. Wird als `-` angezeigt, wenn die Datei keine solche Angabe enthielt, nicht jedes Gerät zeichnet sie auf.
`Path`	Die `.FIT`-Datei, aus der importiert wurde. Das ist der Ort, an dem die Datei zum Importzeitpunkt lag; er wird nicht geprüft und sie liegt womöglich nicht mehr dort.

Ein Gerätename in Klammern nach dem Pfad erscheint nur, wenn die Datei einen mitbrachte. Die meisten tun das nicht, und ein leeres Klammerpaar in jeder Zeile wäre nur Rauschen.

Die Spaltenbreiten richten sich nach dem längsten tatsächlich vorhandenen Wert, sodass eine Datenbank mit kurzen Pfaden keine breite, überwiegend leere Spalte bekommt.

Eine Datenbank ohne Dateien

Eine Datenbank, die angelegt, aber nie befüllt wurde, gibt eine schlichte Feststellung aus und ist erfolgreich. Keine Dateien ist eine Antwort, kein Fehlschlag, und der Exit-Code ist 0:

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

No files recorded.
$ echo $?
0

In einem Skript ist das wichtig: Prüfen Sie den Exit-Code darauf, ob Kent die Datenbank lesen konnte, nicht darauf, ob es etwas gefunden hat.

Ein nicht vorhandener Pfad wird als fehlend gemeldet und nicht angelegt:

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

Eine ältere Datenbank wird abgelehnt

files lehnt eine Datenbank ab, die von einer älteren Cordelia geschrieben wurde als dieser Build erwartet, genauso wie info und details. Der Befehl liest bestimmte benannte Spalten, sodass eine alte Datenbank, die sie nie hatte, sonst mit einem rohen SQLite-Fehler statt mit einer Erklärung scheitern würde.

kent sqldump und kent archive sind die beiden Befehle, die eine solche Datenbank trotzdem lesen. Siehe Fehlermeldungen und Exit-Codes.

Was er nicht ist

files listet die Dateien auf, die importiert wurden. Er listet nicht die Aktivitäten darin auf und zeigt keine der aufgezeichneten Daten. Für Zählungen dessen, was eine Datenbank enthält, siehe kent info und kent details; um die Daten selbst zu lesen, siehe kent archive oder Die importierten Daten ansehen.

Siehe auch Fehlermeldungen und Exit-Codes und .FIT-Dateien importieren.