Paramètres et données de l'application
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).
Où sont stockées les données
| 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 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. 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 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 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
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 | 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 | 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 | 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é recense tous les chemins et explique comment les vérifier vous-même.
Carte de base en ligne
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
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, 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
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 :
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxSur 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.
