Einstellungen und App-Daten
DuckLocal speichert eine Datenbankdatei auf der Festplatte, außerdem eine kleine Datei, solange das Fenster läuft, und eine Protokolldatei. Wenn Sie die Online-Grundkarte aktivieren, speichert es auch Kartenkacheln zwischen; ein heruntergeladenes Update wartet ebenfalls im Cache. Alles andere bleibt für die Dauer der Sitzung im Speicher. Die Review-Kommentare von Dashboards sind eine Ausnahme: Sie liegen neben der Dashboard-Datei, nicht im App-Daten-Verzeichnis (siehe Mit Kommentaren prüfen).
Speicherorte
| Plattform | Pfad |
|---|---|
| macOS | ~/Library/Application Support/DuckLocal/history.duckdb |
| Windows | %APPDATA%\DuckLocal\data\history.duckdb |
| Linux | ~/.local/share/ducklocal/history.duckdb |
Die DuckDB-Datei enthält vier Tabellen: Abfrageverlauf, registrierte Datendateien, neben der geöffneten Datenbank angehängte Datenbanken und eine kleine Einstellungstabelle mit Schlüssel/Wert-Paaren. Zu den Einstellungen gehören die Schnittstellensprache und -größe, offene Abfrage- und Dashboard-Tabs, die Liste der zuletzt verwendeten Dashboards und ob Grundkarte und Update-Prüfung aktiviert sind. Während die App läuft, liegt daneben eine Begleitdatei .wal (DuckDBs Write-Ahead-Log).
Ihre Datensätze werden nie in die Anwendungsdatenbank kopiert. Registrierte Dateien werden als Dateipfade gespeichert und bei jedem Start von DuckLocal automatisch wieder angehängt.
Daneben hält gui-endpoint.json, solange ein Fenster offen ist, den Loopback-Port und ein Zufallstoken, die ducklocal open verwendet, um das Fenster zu erreichen. Nur Ihr Konto kann sie lesen, und eine veraltete gui-endpoint.json, die ein beendetes Fenster hinterlässt, ist harmlos.
Der Ordner logs daneben enthält das Protokoll des Fensters, ducklocal.log (und das des vorigen Starts, ducklocal.previous.log). Wenn DuckLocal abstürzt, schreibt es dort zuerst einen Bericht crash-….log, und der nächste Start sagt, was passiert ist, mit Bericht anzeigen. Die letzten zehn Berichte werden behalten. Hängen Sie den Bericht an, wenn Sie ein Issue melden. Protokollordner öffnen öffnet den Ordner: Unter macOS liegt der Befehl im Menü DuckLocal, überall sonst im Rechtsklickmenü der Version am rechten Ende der Statusleiste. Der Befehl ducklocal schreibt keine Protokolldatei; seine Fehler gehen an seinen Aufrufer.
Kartenkacheln für die Online-Grundkarte landen im Cache-Ordner der Plattform — ~/Library/Caches/DuckLocal/tiles unter macOS, %LOCALAPPDATA%\DuckLocal\cache\tiles unter Windows, ~/.cache/ducklocal/tiles unter Linux —, ein Ordner pro Kachelserver. Ihn zu löschen ist harmlos — die Kacheln werden einfach erneut heruntergeladen. Ein heruntergeladenes Update wartet im Ordner updates im selben Cache-Ordner, bis es installiert wird.
Was einen Neustart übersteht
| Gespeichert | Wo |
|---|---|
| Registrierte Datendateien — Pfad, View-Name, Art | App-Daten-Datei |
| Abfrageverlauf, auch Fehler | App-Daten-Datei |
| Schnittstellensprache | App-Daten-Datei |
| Schnittstellengröße | App-Daten-Datei |
| Ob die Anleitung beim ersten Start gesehen wurde | App-Daten-Datei |
| Ob die Seitenleiste ausgeblendet ist | App-Daten-Datei |
| Neben der geöffneten angehängte Datenbanken und ob jede schreibgeschützt ist | App-Daten-Datei |
| Die zuletzt geöffnete Datenbankdatei | App-Daten-Datei — beim Start erneut geöffnet, solange sie noch existiert |
| Offene Abfrage-Tabs mit ihren Titeln und ihrem SQL | App-Daten-Datei |
| Offene Dashboard-Tabs mit ihren Titeln | App-Daten-Datei |
| Ob die Online-Grundkarte an ist | App-Daten-Datei |
| Ob DuckLocal beim Start nach Updates sucht | App-Daten-Datei |
| Zuletzt geöffnete Dashboards (Dashboards in der Seitenleiste) | App-Daten-Datei |
| Nicht gespeichert | Hinweise |
|---|---|
| Der Inhalt des Ergebnisbereichs | nur im Speicher — führen Sie die Abfrage erneut aus |
| In der In-Memory-Datenbank angelegte Tabellen und Views | beim Beenden oder beim Öffnen einer anderen Datenbank werden Sie gebeten, sie zu speichern; Als Datenbank speichern… schreibt sie in eine .duckdb-Datei |
| Eine Datenbankdatei, die inzwischen verschoben oder gelöscht wurde | der nächste Start beginnt im Speicher |
| Fenstergröße und -position | fest bei 1440×900, mindestens 960×600 |
| Größen von Seitenleiste und Ergebnisbereich | pro Start fest |
| Der Filter der Ergebnisse | nur im Speicher |
| Was die Filter eines Dashboards gewählt haben | nur im Speicher; bleibt über ein Neuladen des Tabs erhalten |
| Das Design | startet immer hell — siehe unten |
| S3-Zugangsdaten | absichtlich nur für die Sitzung |
Das Design ist der Sonderfall: Der Sprachschalter bleibt erhalten, der Design-Schalter nicht, und jeder Start beginnt im hellen Modus.
Ein gewöhnlicher Start arbeitet im Speicher. Tabellen und Views, die Sie dort anlegen, würden also mit dem Fenster enden. DuckLocal fragt vorher nach: Beim Beenden, beim Schließen des Fensters oder beim Öffnen einer anderen Datenbank mit solchen Tabellen bietet es Als Datenbank speichern…, Ohne Speichern beenden oder Abbrechen an. Als Datenbank speichern… (auch ⌘⇧S oder Datei → Als Datenbank speichern…) kopiert Schemas, Tabellen und Zeilen, Views, Makros und Sequenzen in eine .duckdb-Datei und zieht das Fenster auf diese um, spätere Änderungen gehen also in die Datei; der nächste Start öffnet sie wieder. Views, die DuckLocal aus registrierten Dateien anlegt, zählen nicht mit — sie werden bei jedem Start aus den Dateien neu erzeugt.
Netzwerk
DuckLocal macht von sich aus keine Netzwerkanfrage, bis Sie eine einschalten. Es gibt zwei Schalter, beide anfangs aus, plus die Dinge, die Sie direkt anfordern:
| Anfrage | Wann | Was den Rechner verlässt |
|---|---|---|
| Online-Grundkarte | Sobald eingeschaltet, immer wenn eine Karte zeichnet | Welche Kacheln gewünscht sind: ungefähr der betrachtete Bereich und Zoom |
| Update-Prüfung | Wenn Sie auf die Version klicken, oder beim Start, sobald eingeschaltet | Eine Anfrage an dl.ducklocal.app nach der Version des neuesten Releases; gibt es ein neueres, der Download seines Pakets |
| S3 | Wenn Sie S3 konfigurieren und abfragen | Ihre Anfragen an den Speicher, den Sie konfiguriert haben |
| Erweiterungen | Wenn Sie Installieren oder Aktualisieren klicken oder INSTALL ausführen | Ein Download aus DuckDBs Erweiterungs-Repository |
| Entfernte Daten in SQL | Wenn SQL https://, s3:// oder eine entfernte Datenbank nennt, einschließlich des SQL eines Dashboards beim Öffnen. Braucht die bereits installierte Erweiterung | Was das SQL anfordert, einschließlich allem, was in die Adresse geschrieben wurde |
Es gibt keine Telemetrie, und außer dem SQL, das Sie ausführen, sendet nichts davon eine Zeile Ihrer Daten. SQL tut, was es sagt: Eine Adresse kann Werte aus Ihren Tabellen tragen. Sobald httpfs installiert ist, kann eine .dash-Datei von jemandem, dem Sie nicht trauen, beim Öffnen also Daten senden. Netzwerk und Datenschutz listet jeden Pfad auf und wie Sie ihn selbst prüfen können.
Online-Grundkarte
Kartendiagramme — in einem Dashboard oder im Tab Diagramm der Ergebnisse — können OpenStreetMap-Kacheln unter ihren Punkten zeichnen. Ansicht → Online-Grundkarte (OpenStreetMap) schaltet sie ein und aus, und die Wahl wird gespeichert (die Einstellung map_tiles, on oder off). Sie startet ausgeschaltet. Nur die angeforderten Kacheln verlassen den Rechner — ungefähr der Bereich und Zoom, den Sie ansehen —, nie eine Datenzeile.
Das Abrufen folgt der Kachel-Richtlinie der OpenStreetMap Foundation: ein identifizierender User-Agent, höchstens zwei Anfragen gleichzeitig, Kacheln eine Woche lang aus dem Cache wiederverwendet, kein Massen-Vorabruf und die Namensnennung auf der Karte. Für stärkere Nutzung setzen Sie map_tile_url in der Einstellungstabelle auf die {z}/{x}/{y}-URL-Vorlage eines anderen Servers.
Update-Prüfung
Die Statusleiste endet mit der Version von DuckLocal — DuckLocal 0.3.0. Klicken Sie sie an, um dl.ducklocal.app nach dem neuesten Release zu fragen:
- Auf dem neuesten Stand — die Version, die Sie ausführen, ist die neueste.
- v0.3.1 wird heruntergeladen… — es gibt ein neueres Release, und DuckLocal lädt es herunter. Das Paket wird gegen die veröffentlichte Größe und SHA-256 des Releases geprüft — unter macOS auch gegen die Signatur der App, die Sie ausführen —, bevor es entpackt wird.
- Neu starten, um auf v0.3.1 zu aktualisieren — die neue Version ist bereit. Klicken Sie darauf, um zu beenden, zu installieren und neu zu öffnen; sonst installiert sie sich beim nächsten Beenden von DuckLocal.
- Update verfügbar: v0.3.1 — ein neueres Release, das diese Kopie nicht selbst installieren kann: ein Build, den Sie kompiliert haben, oder eine App in einem Ordner, in den sie nicht schreiben darf. Klicken Sie darauf, um das Paket herunterzuladen, und installieren Sie es so, wie Sie diese Version installiert haben.
- Update-Prüfung fehlgeschlagen — fahren Sie darüber für den Grund (offline, ein Proxy, ein Download, der nicht zu seiner Prüfsumme passte); klicken Sie, um es erneut zu versuchen.
Updates kommen von dl.ducklocal.app, dieselben Pakete wie beim GitHub-Release, ausgeliefert von einem Mirror, der auch in Festlandchina schnell ist.
Unter macOS hat das Menü DuckLocal dieselbe Prüfung, als Nach Updates suchen…, und Beim Start nach Updates suchen, die einmal bei jedem App-Start prüft. Sie ist aus, bis Sie sie einschalten (die Einstellung update_check, on oder off). Bis dahin prüft DuckLocal nur, wenn Sie klicken.
Sprache
Die Schaltfläche EN / 中 in der Titelleiste wechselt die Schnittstellensprache sofort und zeichnet die Wahl auf.
Beim ersten Start — bevor eine Einstellung gespeichert ist — wird die Sprache aus dem Systemgebietsschema genommen: LC_ALL oder LANG mit zh darin wählt Chinesisch, alles andere wählt Englisch. Ein nicht erkannter gespeicherter Wert fällt auf Chinesisch zurück.
Einige Zeichenketten werden absichtlich nicht übersetzt: DuckLocal, die Schaltflächenbeschriftungen S3 und EXPLAIN, der Schalter EN / 中 und die Platzhalter für Zugangsdaten. Fehlermeldungen der Engine und des Netzwerks werden wörtlich durchgereicht und sind immer englisch, egal welche Schnittstellensprache eingestellt ist.
Designs
Die Sonne/Mond-Schaltfläche wechselt zwischen hellem und dunklem Design. Es gibt keine Design-Auswahl und keine Designdatei zum Bearbeiten — die beiden Modi sind alles, was Sie bekommen.
Schnittstellengröße
Text, Symbole und Bedienelemente skalieren zusammen, in vier Stufen:
| Größe | Grundtext | Editor-Text |
|---|---|---|
| Klein | 13px | 12px |
| Standard | 14px | 13px |
| Groß | 16px | 15px |
| Sehr groß | 18px | 17px |
Wählen Sie eine über die Schaltfläche Aa in der Titelleiste, oder gehen Sie sie mit ⌘+ (größer), ⌘− (kleiner) und ⌘0 (zurück zum Standard) durch — diese funktionieren, wo immer der Fokus liegt, den SQL-Editor eingeschlossen. Die Wahl wird gespeichert und übersteht den Wechsel zwischen hell und dunkel.
Bereichsgrößen, die Sie gezogen haben, und die Höhe der Plots eines Dashboards bleiben in Pixeln: Sie sind Ihre Sache, nicht die der Schnittstelle.
Zurücksetzen
Um neu anzufangen — Verlauf, registrierte Dateien, angehängte Datenbanken, gespeicherte Tabs und jede Einstellung zu löschen —, beenden Sie DuckLocal und entfernen Sie sein App-Daten-Verzeichnis:
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxAuf Windows löschen Sie %APPDATA%\DuckLocal.
Der nächste Start legt es neu an. Ihre Datendateien sind davon nie betroffen, nur die eigenen Aufzeichnungen von DuckLocal.
Fehlerbehebung
Symptome, Ursachen und Lösungen sind auf der Seite Fehlerbehebung gesammelt.
