# Paramètres et données de l'application

> Où DuckLocal stocke ses données, ce dont il se souvient, ses seules requêtes réseau, la taille de l'interface, le thème et la langue.

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

DuckLocal stocke un fichier de base de données sur le disque, plus un petit fichier tant que la fenêtre est ouverte, et un fichier de journal. Si vous activez la carte de base en ligne, il met aussi en cache les tuiles de carte ; une mise à jour téléchargée attend également dans le cache. Tout le reste demeure en mémoire pendant la session. Les commentaires de relecture des tableaux de bord font exception : ils sont stockés à côté du fichier du tableau de bord, et non dans le dossier de données de l'application (voir [Revoir avec des commentaires](dashboards.md#review-with-comments)).

## Où sont stockées les données {#where-things-are-stored}

| Plateforme | Chemin |
| --- | --- |
| macOS | `~/Library/Application Support/DuckLocal/history.duckdb` |
| Windows | `%APPDATA%\DuckLocal\data\history.duckdb` |
| Linux | `~/.local/share/ducklocal/history.duckdb` |

Le fichier DuckDB contient quatre tables : l'historique des requêtes, les fichiers de données enregistrés, les bases de données attachées à côté de la base ouverte, et une petite table de paramètres clé/valeur. Les paramètres incluent la langue et la taille de l'interface, les onglets de requête et de tableau de bord ouverts, la liste des tableaux de bord récents, et l'activation ou non de la carte de base et de la vérification des mises à jour. Pendant l'exécution de l'application, un fichier `.wal` (le journal d'écriture anticipée de DuckDB) l'accompagne.

Vos jeux de données ne sont jamais copiés dans la base de données de l'application. Les fichiers enregistrés sont stockés sous forme de chemins et automatiquement rattachés à chaque lancement de DuckLocal.

À côté, tant qu'une fenêtre est ouverte, `gui-endpoint.json` contient le port de
bouclage et le jeton aléatoire que
[`ducklocal open`](cli.md#show-work-in-the-running-window) utilise pour joindre la
fenêtre. Seul votre compte peut le lire, et un `gui-endpoint.json` obsolète laissé
par une fenêtre fermée est sans conséquence.

Le dossier `logs` voisin contient le journal de la fenêtre, `ducklocal.log` (et
celui du lancement précédent, `ducklocal.previous.log`). Si DuckLocal plante, il y
écrit d'abord un rapport `crash-….log`, et le lancement suivant explique ce qui
s'est passé, avec **Afficher le rapport**. Les dix derniers rapports sont
conservés. Joignez le rapport lorsque vous
[ouvrez un ticket](https://github.com/JetSquirrel/DuckLocal/issues).
**Ouvrir le dossier des journaux** ouvre le dossier : il se trouve dans le menu
**DuckLocal** sur macOS, et dans le menu contextuel de la version, à l'extrémité
droite de la barre d'état, partout ailleurs. La commande `ducklocal` n'écrit aucun
journal ; ses erreurs vont à son appelant.

Les tuiles de la [carte de base en ligne](#online-base-map) vont dans le dossier de
cache de la plateforme — `~/Library/Caches/DuckLocal/tiles` sur macOS,
`%LOCALAPPDATA%\DuckLocal\cache\tiles` sur Windows, `~/.cache/ducklocal/tiles`
sur Linux — un dossier par serveur de tuiles. Le supprimer est sans conséquence —
les tuiles sont simplement téléchargées à nouveau. Une
[mise à jour](#update-check) téléchargée attend dans `updates`, dans le même
dossier de cache, jusqu'à son installation.

## Ce qui survit à un redémarrage

| Mémorisé | Où |
| --- | --- |
| Fichiers de données enregistrés — chemin, nom de vue, type | fichier de données de l'application |
| Historique des requêtes, y compris les échecs | fichier de données de l'application |
| Langue de l'interface | fichier de données de l'application |
| Taille de l'interface | fichier de données de l'application |
| Si le guide de première utilisation a été vu | fichier de données de l'application |
| Si la barre latérale est masquée | fichier de données de l'application |
| Bases de données attachées à côté de celle qui est ouverte, et si chacune est en lecture seule | fichier de données de l'application |
| Le fichier de base de données ouvert en dernier | fichier de données de l'application — rouvert au lancement tant qu'il existe |
| Onglets de requête ouverts, avec leurs titres et leur SQL | fichier de données de l'application |
| Onglets de tableau de bord ouverts, avec leurs titres | fichier de données de l'application |
| Si la carte de base en ligne est activée | fichier de données de l'application |
| Si DuckLocal vérifie les mises à jour au lancement | fichier de données de l'application |
| Tableaux de bord ouverts récemment (les **Tableaux de bord** de la barre latérale) | fichier de données de l'application |

| Non mémorisé | Remarques |
| --- | --- |
| Le contenu du panneau de résultats | en mémoire uniquement — réexécutez la requête |
| Tables et vues créées dans la base en mémoire | il vous est proposé de les enregistrer quand vous quittez ou ouvrez une autre base de données ; **Enregistrer comme base…** les écrit dans un fichier `.duckdb` |
| Un fichier de base de données déplacé ou supprimé depuis | le lancement suivant démarre en mémoire |
| Taille et position de la fenêtre | fixes à 1440×900, minimum 960×600 |
| Tailles de la barre latérale et du panneau de résultats | fixes pour chaque lancement |
| Le filtre des résultats | en mémoire uniquement |
| Ce que les filtres d'un tableau de bord ont sélectionné | en mémoire uniquement ; conservé lors d'un rechargement de l'onglet |
| **Le thème** | démarre toujours en clair — voir ci-dessous |
| Identifiants S3 | limités à la session, par conception |

Le thème est l'exception : le choix de langue est conservé, celui du thème ne
l'est pas, et chaque lancement commence en mode clair.

Un lancement ordinaire travaille en mémoire, donc les tables et les vues que
vous y créez disparaîtraient avec la fenêtre. DuckLocal demande avant que cela
n'arrive : quitter, fermer la fenêtre ou ouvrir une autre base de données alors
que de telles tables existent propose **Enregistrer comme base…**, **Quitter
sans enregistrer** ou **Annuler**. **Enregistrer comme base…** (aussi ⌘⇧S, ou
**Fichier → Enregistrer comme base…**) copie les schémas, les tables et leurs
lignes, les vues, les macros et les séquences dans un fichier `.duckdb` et
déplace la fenêtre dessus, si bien que les modifications suivantes vont dans le
fichier ; le lancement suivant rouvre ce fichier. Les vues que DuckLocal crée à
partir des fichiers enregistrés ne comptent pas — elles sont refaites à partir
des fichiers à chaque lancement.

## Réseau {#network}

DuckLocal n'émet aucune requête réseau de lui-même tant que vous n'en activez pas
une. Il y a deux interrupteurs, tous deux désactivés au départ, plus les actions
que vous demandez directement :

| Requête | Quand | Ce qui quitte la machine |
| --- | --- | --- |
| [Carte de base en ligne](#online-base-map) | Une fois activée, à chaque tracé de carte | Les tuiles souhaitées : approximativement la zone et le niveau de zoom consultés |
| [Vérification des mises à jour](#update-check) | Lorsque vous cliquez sur la version, ou au lancement une fois activée | Une requête vers `dl.ducklocal.app` pour obtenir la version de la dernière release ; s'il en existe une plus récente, le téléchargement de son paquet |
| [S3](s3.md) | Lorsque vous configurez S3 et l'interrogez | Vos requêtes vers le stockage que vous avez configuré |
| Extensions | Lorsque vous cliquez sur **Installer** ou **Mettre à jour**, ou exécutez `INSTALL` | Un téléchargement depuis le dépôt d'extensions de DuckDB |
| Données distantes en SQL | Lorsqu'un SQL nomme `https://`, `s3://` ou une base de données distante, y compris le SQL d'un tableau de bord à son ouverture. Nécessite l'extension déjà installée | Ce que le SQL demande, y compris tout ce qui est écrit dans l'adresse |

Il n'y a aucune télémétrie, et hormis le SQL que vous exécutez, aucune de ces
requêtes n'envoie une ligne de vos données. Le SQL fait ce qu'il dit : une adresse
peut transporter des valeurs de vos tables. Ainsi, une fois `httpfs` installé, un
fichier `.dash` provenant d'une personne à qui vous ne faites pas confiance peut
envoyer des données lorsque vous l'ouvrez.
[Réseau et confidentialité](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md)
recense tous les chemins et explique comment les vérifier vous-même.

## Carte de base en ligne {#online-base-map}

Les graphiques de carte — dans un tableau de bord ou dans l'onglet **Graphique**
des résultats — peuvent dessiner des tuiles OpenStreetMap sous leurs points.
**Affichage → Carte de base en ligne (OpenStreetMap)** l'active et la désactive,
et le choix est mémorisé (paramètre `map_tiles`, `on` ou `off`). Elle démarre
désactivée. Seules les tuiles demandées quittent la machine — approximativement la
zone et le zoom consultés — jamais une ligne de données.

La récupération suit la politique de tuiles de l'OpenStreetMap Foundation : un
User-Agent identifiant, deux requêtes au maximum à la fois, des tuiles réutilisées
depuis le cache pendant une semaine, aucun préchargement massif, et l'attribution
affichée sur la carte. Pour un usage plus intensif, définissez `map_tile_url` dans
la table des paramètres avec le modèle d'URL `{z}/{x}/{y}` d'un autre serveur.

## Vérification des mises à jour {#update-check}

La barre d'état se termine par la version de DuckLocal — `DuckLocal 0.3.0`.
Cliquez dessus pour vérifier la dernière release sur `dl.ducklocal.app` :

- **À jour** — la version que vous utilisez est la plus récente.
- **Téléchargement de la v0.3.1…** — une release plus récente existe et DuckLocal
  la télécharge. Le paquet est vérifié par rapport à la taille et au SHA-256
  publiés de la release — sur macOS, également par rapport à la signature de
  l'application que vous exécutez — avant d'être décompressé.
- **Redémarrer pour passer en v0.3.1** — la nouvelle version est prête. Cliquez
  pour quitter, installer et rouvrir ; sinon, elle s'installe à votre prochaine
  fermeture de DuckLocal.
- **Mise à jour disponible : v0.3.1** — une release plus récente que cette copie
  ne peut pas installer elle-même : une compilation que vous avez faite, ou une
  application placée dans un dossier où elle n'a pas le droit d'écrire. Cliquez
  pour télécharger le paquet, puis installez-le comme vous avez installé cette
  version.
- **Échec de la vérification des mises à jour** — survolez le message pour en
  connaître la raison (hors ligne, un proxy, un téléchargement dont la somme de
  contrôle ne correspond pas) ; cliquez pour réessayer.

Les mises à jour proviennent de `dl.ducklocal.app`, les mêmes paquets que la
[release GitHub](https://github.com/JetSquirrel/DuckLocal/releases/latest), servis
depuis un miroir rapide également en Chine continentale.

Sur macOS, le menu **DuckLocal** propose la même vérification, sous **Rechercher
les mises à jour…**, ainsi que **Rechercher les mises à jour au lancement**, qui
vérifie une fois à chaque démarrage de l'application. Cette option est désactivée
jusqu'à ce que vous l'activiez (paramètre `update_check`, `on` ou `off`). D'ici là,
DuckLocal ne vérifie que lorsque vous cliquez.

## Langue

Le bouton `EN` / `中` de la barre de titre change immédiatement la langue de
l'interface et enregistre le choix.

Au premier lancement — avant qu'aucun paramètre ne soit enregistré — la langue est
déduite des paramètres régionaux du système : si `LC_ALL` ou `LANG` contient `zh`,
le chinois est sélectionné, sinon l'anglais. Une valeur enregistrée non reconnue
revient au chinois.

Quelques chaînes ne sont volontairement pas traduites : `DuckLocal`, les libellés
des boutons `S3` et `EXPLAIN`, le sélecteur `EN` / `中`, et les textes indicatifs
des identifiants. Les messages d'erreur du moteur et du réseau sont remontés tels
quels et toujours en anglais, quelle que soit la langue de l'interface.

## Thèmes

Le bouton soleil/lune bascule entre le thème clair et le thème sombre. Il n'y a ni
sélecteur de thème ni fichier de thème à modifier — les deux modes sont tout ce
qu'il y a.

## Taille de l'interface {#interface-size}

Le texte, les icônes et les contrôles changent d'échelle ensemble, en quatre
paliers :

| Taille | Texte de base | Texte de l'éditeur |
| --- | --- | --- |
| Petite | 13px | 12px |
| Par défaut | 14px | 13px |
| Grande | 16px | 15px |
| Très grande | 18px | 17px |

Choisissez-en une avec le bouton **Aa** de la barre de titre, ou parcourez-les avec
**⌘+** (plus grande), **⌘−** (plus petite) et **⌘0** (retour à la valeur par
défaut) — ces raccourcis fonctionnent quel que soit l'endroit où se trouve le
focus, y compris dans l'éditeur SQL. Le choix est mémorisé et survit au passage
entre thème clair et thème sombre.

Les tailles de panneaux que vous avez fait glisser, ainsi que la hauteur des
graphiques d'un tableau de bord, restent en pixels : c'est à vous de les ajuster,
pas à l'interface.

## Réinitialiser

Pour repartir de zéro — en effaçant l'historique, les fichiers enregistrés, les
bases de données attachées, les onglets mémorisés et tous les paramètres — quittez
DuckLocal et supprimez son dossier de données d'application :

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

Sur Windows, supprimez `%APPDATA%\DuckLocal`.

Le lancement suivant le recrée. **Vos fichiers de données ne sont jamais affectés
par cette opération**, seuls les enregistrements propres à DuckLocal le sont.

## Dépannage

Symptômes, causes et correctifs sont rassemblés sur la page
[Dépannage](troubleshooting.md).
