Vai al contenuto

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 ​

PiattaformaPercorso
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 ​

RicordatoDove
File di dati registrati — percorso, nome della vista, tipofile dei dati dell'app
Cronologia delle query, compresi i fallimentifile dei dati dell'app
Lingua dell'interfacciafile dei dati dell'app
Dimensione dell'interfacciafile dei dati dell'app
Se la guida al primo avvio è stata vistafile dei dati dell'app
Se la barra laterale è nascostafile dei dati dell'app
Database collegati accanto a quello aperto, e se ognuno è di sola letturafile dei dati dell'app
Il file di database aperto per ultimofile dei dati dell'app — riaperto all'avvio finché esiste ancora
Schede di query aperte, con i loro titoli e l'SQLfile dei dati dell'app
Schede delle dashboard aperte, con i loro titolifile dei dati dell'app
Se la mappa di base online è attivafile dei dati dell'app
Se DuckLocal controlla gli aggiornamenti all'avviofile dei dati dell'app
Dashboard aperte di recente (Dashboard nella barra laterale)file dei dati dell'app
Non ricordatoNote
Il contenuto del pannello dei risultatisolo in memoria — riesegui la query
Tabelle e viste create nel database in memoriati 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 eliminatol'avvio successivo parte in memoria
Dimensione e posizione della finestrafisse a 1440×900, minimo 960×600
Dimensioni della barra laterale e del pannello dei risultatifisse per ogni avvio
Il filtro dei risultatisolo in memoria
Cosa hanno scelto i filtri di una dashboardsolo in memoria; mantenuto al ricaricamento della scheda
Il temaparte sempre in chiaro — vedi sotto
Credenziali S3solo 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:

RichiestaQuandoCosa lascia la macchina
Mappa di base onlineUna volta attivata, ogni volta che viene disegnata una mappaQuali tessere servono: all'incirca l'area e lo zoom visualizzati
Controllo degli aggiornamentiQuando fai clic sulla versione, o all'avvio una volta attivatoUna richiesta a dl.ducklocal.app per la versione dell'ultima release; quando ce n'è una più recente, il download del suo pacchetto
S3Quando configuri S3 e lo interroghiLe tue richieste allo storage che hai configurato
EstensioniQuando fai clic su Installa o Aggiorna, o esegui INSTALLUn download dal repository delle estensioni di DuckDB
Dati remoti in SQLQuando l'SQL nomina https://, s3:// o un database remoto, compreso l'SQL di una dashboard quando si apre. Richiede l'estensione già installataCiò 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:

DimensioneTesto baseTesto dell'editor
Piccola13px12px
Predefinita14px13px
Grande16px15px
Molto grande18px17px

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:

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

Su 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.

Pubblicato con licenza Apache-2.0.