Zum Inhalt springen

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 ​

PlattformPfad
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 ​

GespeichertWo
Registrierte Datendateien — Pfad, View-Name, ArtApp-Daten-Datei
Abfrageverlauf, auch FehlerApp-Daten-Datei
SchnittstellenspracheApp-Daten-Datei
SchnittstellengrößeApp-Daten-Datei
Ob die Anleitung beim ersten Start gesehen wurdeApp-Daten-Datei
Ob die Seitenleiste ausgeblendet istApp-Daten-Datei
Neben der geöffneten angehängte Datenbanken und ob jede schreibgeschützt istApp-Daten-Datei
Die zuletzt geöffnete DatenbankdateiApp-Daten-Datei — beim Start erneut geöffnet, solange sie noch existiert
Offene Abfrage-Tabs mit ihren Titeln und ihrem SQLApp-Daten-Datei
Offene Dashboard-Tabs mit ihren TitelnApp-Daten-Datei
Ob die Online-Grundkarte an istApp-Daten-Datei
Ob DuckLocal beim Start nach Updates suchtApp-Daten-Datei
Zuletzt geöffnete Dashboards (Dashboards in der Seitenleiste)App-Daten-Datei
Nicht gespeichertHinweise
Der Inhalt des Ergebnisbereichsnur im Speicher — führen Sie die Abfrage erneut aus
In der In-Memory-Datenbank angelegte Tabellen und Viewsbeim 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 wurdeder nächste Start beginnt im Speicher
Fenstergröße und -positionfest bei 1440×900, mindestens 960×600
Größen von Seitenleiste und Ergebnisbereichpro Start fest
Der Filter der Ergebnissenur im Speicher
Was die Filter eines Dashboards gewählt habennur im Speicher; bleibt über ein Neuladen des Tabs erhalten
Das Designstartet immer hell — siehe unten
S3-Zugangsdatenabsichtlich 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:

AnfrageWannWas den Rechner verlässt
Online-GrundkarteSobald eingeschaltet, immer wenn eine Karte zeichnetWelche Kacheln gewünscht sind: ungefähr der betrachtete Bereich und Zoom
Update-PrüfungWenn Sie auf die Version klicken, oder beim Start, sobald eingeschaltetEine Anfrage an dl.ducklocal.app nach der Version des neuesten Releases; gibt es ein neueres, der Download seines Pakets
S3Wenn Sie S3 konfigurieren und abfragenIhre Anfragen an den Speicher, den Sie konfiguriert haben
ErweiterungenWenn Sie Installieren oder Aktualisieren klicken oder INSTALL ausführenEin Download aus DuckDBs Erweiterungs-Repository
Entfernte Daten in SQLWenn SQL https://, s3:// oder eine entfernte Datenbank nennt, einschließlich des SQL eines Dashboards beim Öffnen. Braucht die bereits installierte ErweiterungWas 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ößeGrundtextEditor-Text
Klein13px12px
Standard14px13px
Groß16px15px
Sehr groß18px17px

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:

bash
rm -rf ~/Library/Application\ Support/DuckLocal   # macOS
rm -rf ~/.local/share/ducklocal                  # Linux

Auf 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.

Veröffentlicht unter der Apache-2.0-Lizenz.