# Risultati e grafici

> Filtra e copia i risultati delle query di DuckLocal, profila ogni colonna, disegna grafici a barre, linee, dispersione, torta e mappe, ed esporta i risultati in CSV o Parquet.

Source: https://ducklocal.app/docs/it/results-and-charts

Il pannello sotto l'editor ha tre schede: **Risultati**, **Grafico** e
**Panoramica**. A destra delle schede ci sono la dimensione del risultato
(`N rows · M columns`) e i pulsanti **Esporta CSV** e **Esporta Parquet**.

La scheda **Risultati** mostra anche ciò che producono i pulsanti **Explain** e
**Profilo** dell'editor — vedi [Output di Explain e Profilo](#explain-and-profile).

## La griglia dei risultati

La griglia inizia con una colonna `#` per il numero di riga, seguita dalle colonne
del risultato della query. Le colonne numeriche sono allineate a destra. Le
larghezze iniziali sono calcolate dalle intestazioni e dalle prime 200 righe,
contando i caratteri cinesi o giapponesi come larghi due caratteri. Le larghezze
vanno da 80 a 360 pixel con la [dimensione dell'interfaccia](settings-and-data.md#interface-size)
predefinita e si ridimensionano in proporzione con le altre dimensioni. Trascina i
bordi delle colonne per regolare le larghezze; la colonna `#` non si può
ridimensionare. Quando le colonne sono più larghe del pannello, una barra di
scorrimento orizzontale resta visibile sotto di esse.

Fai clic sulle frecce nell'intestazione di una colonna per ordinare le righe caricate
in base a essa: decrescente, poi crescente, poi di nuovo nell'ordine della query. Le
colonne numeriche si ordinano come numeri, tutto il resto come testo (il che mette
in ordine date e orari ISO), `NULL` va in fondo, e le righe con valori uguali
mantengono l'ordine della query. Un [filtro](#filtering) mantiene l'ordinamento, e il
risultato successivo parte senza ordinamento. L'ordinamento è lato client, come il
filtro: per ordinare più righe di quelle caricate, usa `ORDER BY`.

### Visualizzazione delle celle

| Valore | Mostrato come |
| --- | --- |
| `NULL` | il letterale `NULL`, in un colore attenuato |
| BLOB | `<blob N bytes>` |
| GEOMETRY | `<geometry N bytes>` |
| Float con un valore intero | `3.0` |
| Timestamp | `2026-09-17 04:21:09.5` — **in UTC, non nell'ora locale**; la frazione ha tante cifre quante ne ha il valore (nove per TIMESTAMP_NS) |
| Interval | notazione DuckDB, come `1 day 02:00:00` |
| Lista / struct / mappa | formattato in modo leggibile |

Vale la pena ricordare la visualizzazione in UTC se guardi i timestamp a occhio
invece di confrontarli in SQL.

### Filtro {#filtering}

La casella del filtro esegue una corrispondenza di sottostringa senza distinzione
tra maiuscole e minuscole **su tutte le celle** delle righe caricate. È lato client:
non interroga mai il database e copre solo le righe caricate, non la dimensione
reale del risultato.

Il filtro viene applicato quando premi Invio o svuoti la casella, non a ogni
tasto. Mentre un filtro è attivo, la griglia mostra `visible / total rows`
accanto.

## Limiti di righe {#row-limits}

I risultati vengono troncati al primo di questi limiti:

- **100.000 righe**
- **2.000.000 di celle** — quindi un risultato di 400 colonne produce solo circa
  5.000 righe

Il budget di celle esiste perché un tetto di sole righe non limita il lavoro: un
`PIVOT` su una colonna ad alta cardinalità restituisce una colonna per ogni valore
distinto, e formattare decine di milioni di celle sembrerebbe un blocco.

Il troncamento è segnalato in un banner che riporta il numero reale di righe
caricate. **Non esiste paginazione né "carica altro"** — restringi invece la
query.

## Copia

Passando il cursore su una cella compare un pulsante di copia che mette il testo di
quella cella negli appunti. Fai clic destro su una cella per **Copia cella**,
**Copia riga** (separata da tabulazioni) o **Copia colonna** (un valore per riga,
nell'ordine mostrato). Fai clic destro sul numero di una riga per copiare la sua
riga. Le copie seguono il filtro e l'ordinamento correnti. Le tabelle delle
dashboard offrono le stesse tre azioni di copia. Non c'è selezione di intervallo né
"copia come SQL"; per più di una riga o di una colonna, usa
[Esporta](#export).

## Esporta {#export}

**Esporta CSV** e **Esporta Parquet** aprono una piccola finestra con un campo per il
percorso, precompilato con `~/Desktop/export.csv` o `~/Desktop/export.parquet`.

Due cose da sapere:

- L'esportazione **riesegue l'SQL che ha prodotto le righe attuali**, quindi il file
  contiene l'intero set di risultati della query — non la vista filtrata e non la
  griglia troncata.
- Non c'è un selettore di file né una richiesta di conferma della sovrascrittura.
  Scrivi un percorso e viene scritto.

## Grafici {#charts}

Finché non scegli le colonne, un grafico viene disegnato dalle righe già presenti
nella griglia, nell'ordine in cui la query le ha restituite, senza aggregazione. I
menu [**X**, **Y** e **Split**](#pick-columns) fanno invece raggruppare da DuckDB
l'intero risultato.

Il selettore sopra il grafico parte da **Auto**, che sceglie in base alle colonne
del risultato:

| Il risultato ha | Auto disegna |
| --- | --- |
| Una colonna di latitudine e una di longitudine | Una mappa |
| Una prima colonna temporale (date / timestamp) | Un grafico ad area; la x è la colonna 0, una serie per ogni colonna numerica |
| Qualsiasi altra cosa | Un grafico a barre; la colonna 0 è l'etichetta, la prima colonna numerica è il valore |

"Colonna numerica" include la prima colonna: se la colonna 0 è un numero — un'ora,
un anno, un ID — diventa il valore del grafico a barre, non la sua etichetta.
Convertila in testo (`year::VARCHAR`, oppure `format('{:02d}:00', hour(ts))`) per
farla diventare l'etichetta.

**Barre**, **Linea**, **Area** e **Dispersione** sono a un clic per qualsiasi
risultato; **Torta** per un risultato la cui prima colonna non è un tempo, e
**Mappa** per uno con coordinate. La scelta viene mantenuta tra un'esecuzione e
l'altra; quando un nuovo risultato non può disegnarla — una mappa senza coordinate
— il grafico torna alla scelta di Auto senza dimenticare la tua.

### Scegli le colonne {#pick-columns}

I menu **X**, **Y** e **Split** sopra il grafico scelgono cosa disegna. **Y** è il
conteggio delle righe, oppure la somma, la media, il minimo o il massimo di un
numero. DuckDB raggruppa allora l'intero risultato invece delle righe caricate, e
conserva le 200 categorie più grandi (o i primi 50.000 valori ordinati) e le 12
serie più grandi. Un avviso dice cosa è stato escluso.

- Con uno **Split** scelto, **Impilato** e **Mappa di calore** si aggiungono al
  selettore del grafico, e **Torta** ne esce.
- **Istogramma** è offerto quando c'è un numero da suddividere in intervalli.
  DuckDB raggruppa l'intero risultato.
- **Copia come .dash** copia la tua scelta come blocco `query` e blocco `plot` che
  disegnano lo stesso grafico in una [dashboard](dashboards.md).

Senza una scelta, un grafico di un risultato troncato dice **Disegnato dalle prime
N righe caricate dalla griglia, non dall'intero risultato**. Una serie temporale
troncata viene rieseguita in background e mediata su tutte le righe.

### Tipi di grafico e limiti

Una **torta** disegna il valore della prima colonna numerica per etichetta, dal più
grande al più piccolo. I valori zero, negativi e mancanti non vengono disegnati
come spicchi, e un avviso li conta; oltre 8 spicchi, i 7 più grandi mantengono il
loro spicchio e il resto confluisce in "altro".

Una **mappa** viene scelta in base ai nomi delle colonne:

- **Latitudine:** `lat`, `latitude`, o qualsiasi nome che li contenga (`geo_lat`,
  `start_lat`) — anche `纬度` funziona.
- **Longitudine:** `lng`, `lon`, `long`, `longitude`, allo stesso modo — anche
  `经度` funziona.

Ogni riga è un punto su una proiezione Web Mercator adattata ai punti, sopra una
griglia di latitudine/longitudine etichettata in gradi; una colonna di testo con
pochi valori distinti li colora. Passa il cursore su un punto per vedere la sua
riga.

Sotto i punti si può disegnare una mappa di base OpenStreetMap: attivala con
**Visualizza → Mappa di base online (OpenStreetMap)**. È disattivata per
impostazione predefinita perché caricare le tessere richiede la rete — le richieste
rivelano all'incirca l'area visualizzata, mai le tue righe. Le tessere vengono
messe in cache per una settimana; offline, la mappa viene disegnata solo sopra la
griglia di latitudine/longitudine.

Le righe le cui celle di valore non sono numeriche — `NULL`, per esempio — vengono
scartate prima di disegnare.

Limiti, tutti annunciati in una riga di avviso sotto il titolo del grafico:

| Limite | Comportamento |
| --- | --- |
| 12 serie | Le colonne numeriche in più vengono scartate |
| 1.500 punti | La serie viene raggruppata in intervalli e **mediata** all'interno di ciascuno |
| 200 barre | Le barre in eccesso vengono troncate, non unite |
| 8 spicchi della torta | I più piccoli confluiscono in "altro" |
| 20.000 punti della mappa | I punti in eccesso vengono omessi |

Il titolo riporta sempre quanti punti sono stati disegnati, quindi controllalo
prima di fidarti della forma di una curva.

## Panoramica delle colonne {#overview}

La scheda **Panoramica** descrive insieme tutte le colonne del risultato attuale:
quanto sono piene, quanti valori assumono, il loro intervallo e che aspetto hanno i
loro valori.

La riga di intestazione dice `Current result · N rows · M columns · took …`. Poi
ogni colonna ha una riga:

| Parte | Cosa mostra |
| --- | --- |
| Nome e tipo | Il nome della colonna e il suo tipo DuckDB |
| Null | La quota di righe che sono `NULL`, con una piccola barra; evidenziata quando supera lo 0% |
| Distinti | `~N distinct` — la stima di DuckDB del numero di valori distinti |
| Intervallo | Minimo – massimo, oppure l'unico valore quando coincidono |
| Mediana | Per numeri, date e timestamp |
| Distribuzione | Un piccolo grafico, descritto sotto |

La distribuzione dipende dal tipo della colonna:

- **Numeri, date e timestamp** ricevono un istogramma di circa 12 barre di uguale
  larghezza. Una colonna con un solo valore elenca invece quel valore.
- **Testo e booleani** elencano i loro 5 valori più comuni, ciascuno con la sua
  quota di righe; passa il cursore su un valore per il conteggio esatto. Oltre
  circa 10.000 valori distinti i valori vengono stimati ed elencati sotto *Valori
  comuni (stimati)*, senza quote.
- **Liste, struct, mappe e union** non ricevono alcun grafico.

Come funziona:

- **La panoramica riesegue la query**, intera, in due scansioni: `SUMMARIZE` per le
  statistiche, poi un `SELECT` per la distribuzione di ogni colonna. Copre quindi
  il risultato completo, non solo le righe che la griglia ha conservato entro i
  suoi [limiti di righe](#row-limits) — e una query lenta torna a essere lenta. Una
  query non deterministica (`random()`, `USING SAMPLE`) viene descritta come è
  uscita in quella seconda esecuzione.
- Viene calcolato quando apri la scheda, e di nuovo per ogni nuovo risultato mentre
  la scheda è aperta.
- **Solo una query che può stare dentro `FROM ( … )` può essere riepilogata**: una
  che inizia con `SELECT`, `WITH`, `FROM`, `VALUES`, `TABLE`, `PIVOT` o `UNPIVOT`
  (i commenti `--` iniziali vengono saltati). Qualsiasi altra cosa — `SHOW`,
  `DESCRIBE`, `PRAGMA`, `CALL`, `SUMMARIZE` — riceve *Solo il risultato di una
  query (SELECT, WITH, FROM…) può essere riepilogato: la panoramica la riesegue.*

Per riepilogare un'intera tabella, vista o file registrato senza scrivere una
query, fai clic destro su di essa nella barra laterale e scegli **Panoramica delle
colonne**. Questo mette `FROM <name>;` nell'editor, la esegue e apre questa scheda.
Vedi [Menu contestuale](schema-and-history.md#right-click-menu).

## Output di Explain e Profilo {#explain-and-profile}

I [pulsanti **Explain** e **Profilo**](sql-editor.md#explain-and-profile) nella
barra degli strumenti dell'editor mostrano il loro output nella scheda
**Risultati**, passando ad essa se era aperta un'altra scheda. Ognuno dei due
sostituisce la griglia; riesegui la query per riavere le sue righe.

**Explain** mostra il piano di DuckDB come testo monospaziato sotto una riga
`EXPLAIN · took …`.

**Profilo** mostra il piano che è stato realmente eseguito come un albero, una
riga per operatore, ciascuno indentato sotto l'operatore a cui alimenta:

- una barra per la quota di tempo dell'operatore sul tempo totale di tutti gli
  operatori;
- il tempo proprio dell'operatore, escluso quello dei suoi figli;
- il suo nome, come `TABLE_SCAN`, `FILTER` o `HASH_GROUP_BY`;
- `N rows` — le righe che ha prodotto;
- `est. N` — la stima dell'ottimizzatore per quelle righe, dove il piano ne ha una.
  È evidenziata quando sbaglia di più di 10× in un senso o nell'altro (passa il
  cursore per *Stima sbagliata di più di 10×*): un errore di quella dimensione è
  una causa comune di un join lento;
- sotto, ciò con cui l'operatore ha lavorato: filtri, chiavi di join, proiezioni.

La riga di intestazione dice `Profile · took … · operators …`: il tempo di
orologio, poi la somma dei tempi propri degli operatori. I due differiscono, perché
gli operatori di una stessa pipeline vengono eseguiti in modo intercalato; le barre
sono quote del secondo. Accanto, `Hottest: NAME (time)` nomina l'operatore che è
costato di più da solo, e la riga di quell'operatore è disegnata in rosso.
