# Einstellungen und App-Daten

> Wo DuckLocal seine Daten speichert, was es sich merkt, welche Netzwerkanfragen es überhaupt machen kann, Schnittstellengröße, Design und Sprache und wie Sie es zurücksetzen.

Source: https://ducklocal.app/docs/de/settings-and-data

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](dashboards.md#review-with-comments)).

## Speicherorte {#where-things-are-stored}

| 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`](cli.md#show-work-in-the-running-window)
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](https://github.com/JetSquirrel/DuckLocal/issues).
**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](#online-base-map) 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](#update-check) 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 {#network}

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](#online-base-map) | Sobald eingeschaltet, immer wenn eine Karte zeichnet | Welche Kacheln gewünscht sind: ungefähr der betrachtete Bereich und Zoom |
| [Update-Prüfung](#update-check) | 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](s3.md) | 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](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md)
listet jeden Pfad auf und wie Sie ihn selbst prüfen können.

## Online-Grundkarte {#online-base-map}

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 {#update-check}

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](https://github.com/JetSquirrel/DuckLocal/releases/latest),
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 {#interface-size}

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:

```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](troubleshooting.md) gesammelt.
