# Impostazioni e dati dell'app

> Dove DuckLocal memorizza i suoi dati, cosa ricorda, le uniche richieste di rete che può fare, la dimensione dell'interfaccia, il tema e la lingua, e come ripristinarla.

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

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](dashboards.md#review-with-comments)).

## Dove sono memorizzate le cose {#where-things-are-stored}

| 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`](cli.md#show-work-in-the-running-window)
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](https://github.com/JetSquirrel/DuckLocal/issues).
**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](#online-base-map) 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](#update-check) 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 {#network}

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](#online-base-map) | Una volta attivata, ogni volta che viene disegnata una mappa | Quali tessere servono: all'incirca l'area e lo zoom visualizzati |
| [Controllo degli aggiornamenti](#update-check) | 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](s3.md) | 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](https://github.com/JetSquirrel/DuckLocal/blob/main/docs/network-and-privacy.md)
elenca ogni percorso e come verificarlo da solo.

## Mappa di base online {#online-base-map}

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 {#update-check}

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](https://github.com/JetSquirrel/DuckLocal/releases/latest), 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 {#interface-size}

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:

```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](troubleshooting.md).
