Impostazioni e dati dell'app
DuckLocal memorizza un file di database su disco, più un piccolo file mentre la finestra è in esecuzione, e un file di log. Se attivi la mappa di base online, mette in cache anche le tessere della mappa; anche un aggiornamento scaricato attende nella cache. Tutto il resto resta in memoria per la durata della sessione. I commenti di revisione delle dashboard sono un'eccezione: sono memorizzati accanto al file della dashboard, non nella cartella dei dati dell'app (vedi Revisione con commenti).
Dove sono memorizzate le cose
| Piattaforma | Percorso |
|---|---|
| macOS | ~/Library/Application Support/DuckLocal/history.duckdb |
| Windows | %APPDATA%\DuckLocal\data\history.duckdb |
| Linux | ~/.local/share/ducklocal/history.duckdb |
Il file DuckDB contiene quattro tabelle: cronologia delle query, file di dati registrati, database collegati accanto al database aperto e una piccola tabella di impostazioni chiave/valore. Le impostazioni comprendono la lingua e la dimensione dell'interfaccia, le schede di query e delle dashboard aperte, l'elenco delle dashboard recenti e se la mappa di base e il controllo degli aggiornamenti sono attivi. Mentre l'app è in esecuzione, accanto c'è un file .wal (il write-ahead log di DuckDB).
I tuoi set di dati non vengono mai copiati nel database dell'applicazione. I file registrati sono memorizzati come percorsi di file e vengono ricollegati automaticamente ogni volta che DuckLocal si avvia.
Accanto, mentre una finestra è aperta, gui-endpoint.json contiene la porta di loopback e il token casuale che ducklocal open usa per raggiungere la finestra. Solo il tuo account può leggerlo, e un gui-endpoint.json obsoleto lasciato da una finestra chiusa è innocuo.
La cartella logs accanto contiene il log della finestra, ducklocal.log (e quello dell'avvio precedente, ducklocal.previous.log). Se DuckLocal va in crash, vi scrive prima un rapporto crash-….log, e l'avvio successivo racconta cosa è successo, con Mostra rapporto. Vengono conservati gli ultimi dieci rapporti. Allega il rapporto quando apri una segnalazione. Apri cartella dei log apre la cartella: si trova nel menu DuckLocal su macOS, e nel menu contestuale della versione all'estremità destra della barra di stato ovunque. Il comando ducklocal non scrive alcun file di log; i suoi errori vanno a chi lo chiama.
Le tessere della mappa per la mappa di base online vanno nella cartella della cache della piattaforma — ~/Library/Caches/DuckLocal/tiles su macOS, %LOCALAPPDATA%\DuckLocal\cache\tiles su Windows, ~/.cache/ducklocal/tiles su Linux — una cartella per server di tessere. Cancellarla è innocuo: le tessere vengono semplicemente scaricate di nuovo. Un aggiornamento scaricato attende in updates, nella stessa cartella della cache, finché non viene installato.
Cosa sopravvive a un riavvio
| Ricordato | Dove |
|---|---|
| File di dati registrati — percorso, nome della vista, tipo | file dei dati dell'app |
| Cronologia delle query, compresi i fallimenti | file dei dati dell'app |
| Lingua dell'interfaccia | file dei dati dell'app |
| Dimensione dell'interfaccia | file dei dati dell'app |
| Se la guida al primo avvio è stata vista | file dei dati dell'app |
| Se la barra laterale è nascosta | file dei dati dell'app |
| Database collegati accanto a quello aperto, e se ognuno è di sola lettura | file dei dati dell'app |
| Il file di database aperto per ultimo | file dei dati dell'app — riaperto all'avvio finché esiste ancora |
| Schede di query aperte, con i loro titoli e l'SQL | file dei dati dell'app |
| Schede delle dashboard aperte, con i loro titoli | file dei dati dell'app |
| Se la mappa di base online è attiva | file dei dati dell'app |
| Se DuckLocal controlla gli aggiornamenti all'avvio | file dei dati dell'app |
| Dashboard aperte di recente (Dashboard nella barra laterale) | file dei dati dell'app |
| Non ricordato | Note |
|---|---|
| Il contenuto del pannello dei risultati | solo in memoria — riesegui la query |
| Tabelle e viste create nel database in memoria | ti viene chiesto di salvarle quando esci o apri un altro database; Salva come database… le scrive in un file .duckdb |
| Un file di database che nel frattempo è stato spostato o eliminato | l'avvio successivo parte in memoria |
| Dimensione e posizione della finestra | fisse a 1440×900, minimo 960×600 |
| Dimensioni della barra laterale e del pannello dei risultati | fisse per ogni avvio |
| Il filtro dei risultati | solo in memoria |
| Cosa hanno scelto i filtri di una dashboard | solo in memoria; mantenuto al ricaricamento della scheda |
| Il tema | parte sempre in chiaro — vedi sotto |
| Credenziali S3 | solo di sessione per scelta |
Il tema è il caso strano: l'interruttore della lingua persiste, quello del tema no, e ogni avvio inizia in modalità chiara.
Un avvio normale lavora in memoria, quindi le tabelle e le viste che crei lì finirebbero con la finestra. DuckLocal chiede prima che accada: uscire, chiudere la finestra o aprire un altro database con tali tabelle in essere offre Salva come database…, Esci senza salvare o Annulla. Salva come database… (anche ⌘⇧S, o File → Salva come database…) copia schemi, tabelle e righe, viste, macro e sequenze in un file .duckdb e sposta la finestra su di esso, così le modifiche successive vengono scritte nel file; l'avvio successivo apre di nuovo quel file. Le viste che DuckLocal crea dai file registrati non contano — vengono ricreate dai file a ogni avvio.
Rete
DuckLocal non fa alcuna richiesta di rete da solo finché non ne attivi una. Ci sono due interruttori, entrambi disattivati all'inizio, più le cose che chiedi direttamente:
| Richiesta | Quando | Cosa lascia la macchina |
|---|---|---|
| Mappa di base online | Una volta attivata, ogni volta che viene disegnata una mappa | Quali tessere servono: all'incirca l'area e lo zoom visualizzati |
| Controllo degli aggiornamenti | Quando fai clic sulla versione, o all'avvio una volta attivato | Una richiesta a dl.ducklocal.app per la versione dell'ultima release; quando ce n'è una più recente, il download del suo pacchetto |
| S3 | Quando configuri S3 e lo interroghi | Le tue richieste allo storage che hai configurato |
| Estensioni | Quando fai clic su Installa o Aggiorna, o esegui INSTALL | Un download dal repository delle estensioni di DuckDB |
| Dati remoti in SQL | Quando l'SQL nomina https://, s3:// o un database remoto, compreso l'SQL di una dashboard quando si apre. Richiede l'estensione già installata | Ciò che chiede l'SQL, compreso qualsiasi cosa scritta nell'indirizzo |
Non c'è telemetria e, a parte l'SQL che esegui, nessuna di queste invia una riga dei tuoi dati. L'SQL fa ciò che dice: un indirizzo può portare valori dalle tue tabelle. Quindi, una volta installato httpfs, un file .dash di qualcuno di cui non ti fidi può inviare dati quando lo apri. Rete e privacy elenca ogni percorso e come verificarlo da solo.
Mappa di base online
Le mappe dei grafici — in una dashboard o nella scheda Grafico dei risultati — possono disegnare tessere OpenStreetMap sotto i loro punti. Visualizza → Mappa di base online (OpenStreetMap) la attiva e la disattiva, e la scelta viene ricordata (l'impostazione map_tiles, on o off). Parte disattivata. Solo le tessere richieste lasciano la macchina — all'incirca l'area e lo zoom che stai guardando — mai una riga di dati.
Il download segue la politica delle tessere della OpenStreetMap Foundation: un User-Agent identificativo, al massimo due richieste alla volta, tessere riutilizzate dalla cache per una settimana, nessun prefetch massivo e l'attribuzione sulla mappa. Per un uso più intenso, imposta map_tile_url nella tabella delle impostazioni sul modello {z}/{x}/{y} di un altro server.
Controllo degli aggiornamenti
La barra di stato termina con la versione di DuckLocal — DuckLocal 0.3.0. Fai clic per controllare su dl.ducklocal.app l'ultima release:
- Aggiornato — la versione che esegui è la più recente.
- Download di v0.3.1… — c'è una release più recente e DuckLocal la sta scaricando. Il pacchetto viene verificato rispetto alla dimensione pubblicata e allo SHA-256 della release — su macOS, anche rispetto alla firma dell'app che stai eseguendo — prima di essere scompattato.
- Riavvia per aggiornare alla v0.3.1 — la nuova versione è pronta. Fai clic per uscire, installare e riaprire; altrimenti si installa la prossima volta che esci da DuckLocal.
- Aggiornamento disponibile: v0.3.1 — una release più recente che questa copia non può installare da sola: una build compilata da te, o un'app in una cartella in cui non può scrivere. Fai clic per scaricare il pacchetto e installalo come hai installato questa.
- Controllo aggiornamenti non riuscito — passa il cursore per il motivo (offline, un proxy, un download che non corrispondeva al suo checksum); fai clic per riprovare.
Gli aggiornamenti arrivano da dl.ducklocal.app, gli stessi pacchetti della release GitHub, serviti da un mirror veloce anche nella Cina continentale.
Su macOS il menu DuckLocal ha lo stesso controllo, come Controlla gli aggiornamenti…, e Controlla gli aggiornamenti all'avvio, che controlla una volta ogni volta che l'app si avvia. È disattivato finché non lo attivi (l'impostazione update_check, on o off). Fino ad allora, DuckLocal controlla solo quando fai clic.
Lingua
Il pulsante EN / 中 nella barra del titolo cambia la lingua dell'interfaccia immediatamente e registra la scelta.
Al primo avvio — prima che sia memorizzata qualsiasi impostazione — la lingua viene presa dalla locale di sistema: LC_ALL o LANG che contiene zh seleziona il cinese, qualsiasi altra cosa seleziona l'inglese. Un valore memorizzato non riconosciuto torna al cinese.
Alcune stringhe non vengono tradotte di proposito: DuckLocal, le etichette dei pulsanti S3 e EXPLAIN, l'interruttore EN / 中 e i segnaposto delle credenziali. I messaggi di errore del motore e della rete vengono mostrati così come sono e sono sempre in inglese, qualunque sia la lingua dell'interfaccia.
Temi
Il pulsante sole/luna alterna tra tema chiaro e scuro. Non c'è un selettore di temi né un file di tema da modificare — le due modalità sono quello che c'è.
Dimensione dell'interfaccia
Testo, icone e controlli si ridimensionano insieme, in quattro passi:
| Dimensione | Testo base | Testo dell'editor |
|---|---|---|
| Piccola | 13px | 12px |
| Predefinita | 14px | 13px |
| Grande | 16px | 15px |
| Molto grande | 18px | 17px |
Scegline una dal pulsante Aa nella barra del titolo, o passale una per una con ⌘+ (più grande), ⌘− (più piccola) e ⌘0 (torna alla predefinita) — funzionano ovunque sia il focus, compreso l'editor SQL. La scelta viene ricordata e sopravvive al passaggio tra chiaro e scuro.
Le dimensioni dei pannelli che hai trascinato, e l'altezza dei grafici di una dashboard, restano in pixel: sono tue da regolare, non dell'interfaccia.
Ripristino
Per ricominciare da zero — cancellando cronologia, file registrati, database collegati, schede ricordate e ogni impostazione — esci da DuckLocal e rimuovi la sua cartella dei dati dell'app:
rm -rf ~/Library/Application\ Support/DuckLocal # macOS
rm -rf ~/.local/share/ducklocal # LinuxSu Windows, elimina %APPDATA%\DuckLocal.
L'avvio successivo la crea da zero. I tuoi file di dati non sono mai toccati da questo, solo i registri propri di DuckLocal.
Risoluzione dei problemi
Sintomi, cause e soluzioni sono raccolti nella pagina Risoluzione dei problemi.
