Aller au contenu

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 ​

PlateformeChemin
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, typefichier de données de l'application
Historique des requêtes, y compris les échecsfichier de données de l'application
Langue de l'interfacefichier de données de l'application
Taille de l'interfacefichier de données de l'application
Si le guide de première utilisation a été vufichier de données de l'application
Si la barre latérale est masquéefichier 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 seulefichier de données de l'application
Le fichier de base de données ouvert en dernierfichier de données de l'application — rouvert au lancement tant qu'il existe
Onglets de requête ouverts, avec leurs titres et leur SQLfichier de données de l'application
Onglets de tableau de bord ouverts, avec leurs titresfichier de données de l'application
Si la carte de base en ligne est activéefichier de données de l'application
Si DuckLocal vérifie les mises à jour au lancementfichier 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ésultatsen mémoire uniquement — réexécutez la requête
Tables et vues créées dans la base en mémoireil 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é depuisle lancement suivant démarre en mémoire
Taille et position de la fenêtrefixes à 1440×900, minimum 960×600
Tailles de la barre latérale et du panneau de résultatsfixes pour chaque lancement
Le filtre des résultatsen 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èmedémarre toujours en clair — voir ci-dessous
Identifiants S3limité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êteQuandCe qui quitte la machine
Carte de base en ligneUne fois activée, à chaque tracé de carteLes tuiles souhaitées : approximativement la zone et le niveau de zoom consultés
Vérification des mises à jourLorsque vous cliquez sur la version, ou au lancement une fois activéeUne 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
S3Lorsque vous configurez S3 et l'interrogezVos requêtes vers le stockage que vous avez configuré
ExtensionsLorsque vous cliquez sur Installer ou Mettre à jour, ou exécutez INSTALLUn téléchargement depuis le dépôt d'extensions de DuckDB
Données distantes en SQLLorsqu'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éeCe 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 :

TailleTexte de baseTexte de l'éditeur
Petite13px12px
Par défaut14px13px
Grande16px15px
Très grande18px17px

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.

Publié sous licence Apache-2.0.