Risultati e grafici
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.
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 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 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
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
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.
Esporta
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
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 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
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
querye bloccoplotche disegnano lo stesso grafico in una dashboard.
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
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:
SUMMARIZEper le statistiche, poi unSELECTper 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 — 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 conSELECT,WITH,FROM,VALUES,TABLE,PIVOToUNPIVOT(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.
Output di Explain e Profilo
I pulsanti Explain e Profilo 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,FILTERoHASH_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.
