Warum wird meine SQLite-Datenbank in TablePlus nicht erkannt?
- Mögliche Ursachen: Dateiformat und Dateiendung
- Beschädigte oder unvollständige Datei
- Dateiberechtigungen und Zugriffskonflikte
- Verschlüsselung oder proprietäres Format
- Inkompatible SQLite-Version oder WAL-Journal-Zustand
- Fehler beim Öffnen in TablePlus (Einstellungen/Verbindungsart)
- Fehlerbehebung und Prüfungen
Mögliche Ursachen: Dateiformat und Dateiendung
TablePlus erkennt eine Datenbankdatei hauptsächlich anhand des Dateiformats und oft der Endung. Eine SQLite-Datenbank sollte gewöhnlich die Endung .sqlite, .db oder .sqlite3 haben. Wenn die Datei eine andere Endung hat oder umbenannt wurde, kann TablePlus sie unter Umständen nicht automatisch als SQLite erkennen. Ebenso kann eine Datei, die nur wie eine SQLite-Datei heißt, aber ein anderes Format oder kein gültiges DB-Format enthält (z. B. ein Leak- oder Backup-Container), nicht geöffnet werden.
Beschädigte oder unvollständige Datei
Wenn die Datei während Kopiervorgängen, Downloads oder auf einem unsicheren Medium beschädigt wurde, fehlen die typischen SQLite-Headerbytes ("SQLite format 3"). TablePlus prüft diese Signatur; fehlt sie, meldet die App, dass es keine gültige SQLite-Datenbank sei. Auch unvollständige Dateien (z. B. nur Teildownloads oder abgebrochene Exporte) führen zum gleichen Problem.
Dateiberechtigungen und Zugriffskonflikte
Betriebssystemberechtigungen können TablePlus daran hindern, auf die Datei zuzugreifen. Wenn der Benutzer, unter dem TablePlus läuft, keine Leserechte hat oder die Datei von einem anderen Prozess exklusiv gesperrt ist, erscheint die DB für TablePlus nicht als öffnungsfähig. Auf macOS können zusätzlich Sicherheitseinstellungen (z. B. Filesystem-Privacy in den Systemeinstellungen) den Zugriff blockieren.
Verschlüsselung oder proprietäres Format
Manche Anwendungen speichern SQLite-Daten verschlüsselt oder verwenden eine proprietäre Verpackung (z. B. WAL/journal kombiniert mit externen Metadaten oder ein verschlüsseltes Containerformat). Ohne Entschlüsselungsschlüssel oder das passende Formatierungsverfahren erkennt TablePlus die Datei nicht als verwendbare SQLite-Datenbank.
Inkompatible SQLite-Version oder WAL-Journal-Zustand
Ältere oder sehr neue SQLite-Features bzw. spezielle Compile-Optionen können inkompatibel sein. Wenn die Datenbank im Write-Ahead-Log-Modus (WAL) einen unvollständigen WAL-File-Zustand hat und die zugehörenden WAL/SHM-Dateien fehlen oder nicht am erwarteten Ort sind, kann die DB inkonsistent erscheinen. TablePlus versucht normalerweise, WAL zu handhaben, aber fehlende Dateien können Probleme verursachen.
Fehler beim Öffnen in TablePlus (Einstellungen/Verbindungsart)
Bei TablePlus muss man beim Erstellen einer neuen Verbindung die richtige Datenbankart (SQLite) auswählen und die Datei korrekt angeben. Wird stattdessen ein falscher Treiber/Connection Type gewählt (z. B. MySQL/Postgres), erkennt die App die Datei nicht. Außerdem können Pfadangaben mit Sonderzeichen oder Netzwerkpfade Probleme bereiten.
Fehlerbehebung und Prüfungen
Überprüfen Sie die Dateiendung und die Größe; öffnen Sie die Datei in einem Hex-Editor und suchen Sie nach dem Header "SQLite format 3". Testen Sie mit dem Kommandozeilen-Tool sqlite3, ob die Datei geöffnet wird (sqlite3 datei.db ".tables"). Prüfen Sie Dateiberechtigungen und entfernen Sie mögliche Sperren durch andere Prozesse. Falls Verschlüsselung vermutet wird, klären Sie das Format und den Schlüssel. Stellen Sie sicher, dass WAL/SHM-Dateien vorhanden sind und im selben Verzeichnis liegen. Schließlich wählen Sie in TablePlus explizit "Open" → "SQLite" und navigieren zur Datei, statt eine generische Verbindung anzulegen.