---
title: Interroga file CSV con SQL, senza configurare un database | DuckLocal
description: "Esegui SQL su file CSV senza importarli in un database. DuckLocal legge i CSV sul posto con DuckDB: join, aggregazioni, grafici ed esportazione in Parquet. Gratuito e locale."
image: https://ducklocal.app/og-image.jpg
language: it
---

# Interroga i file CSV con SQL

Trascina un file CSV su DuckLocal e diventa una tabella con il nome del file. DuckDB individua il delimitatore, l'intestazione e i tipi delle colonne, così puoi usare subito `SELECT`, `JOIN` e `GROUP BY`. Non c'è alcun passaggio di importazione né `CREATE TABLE`, e i file troppo grandi per un foglio di calcolo sono comunque a una query di distanza.

## Da un file CSV a un risultato

Il file resta dove si trova. DuckLocal lo legge sul posto.

1. **Trascina il file.** `sales.csv` diventa una vista chiamata `sales`. I file `.tsv` separati da tabulazioni, i file `.txt` e i file `.csv.gz` compressi con gzip funzionano allo stesso modo.
2. **Scrivi SQL sul file.** La barra laterale dello schema mostra le colonne e i loro tipi dedotti, e il completamento automatico li conosce. Usa l'intero dialetto SQL di DuckDB: join, funzioni finestra, CTE e `PIVOT`.
3. **Conserva la risposta.** Trasforma il risultato in un grafico, guarda la distribuzione di ogni colonna oppure esporta il risultato completo in CSV o Parquet.

## Fai join dei file CSV come tabelle

Apri insieme `orders.csv` e `customers.csv` e ognuno diventa una vista a sé. Fai join in un'unica istruzione, oppure fai join di un file CSV con un file Parquet, un foglio Excel o una tabella in un database DuckDB.

[L'editor SQL](https://ducklocal.app/docs/it/sql-editor) · [Risultati e grafici](https://ducklocal.app/docs/it/results-and-charts)

```sql
SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;
```

## Molti file, e anche disordinati

Leggi un'intera cartella di file CSV come un'unica tabella con `read_csv`. `union_by_name` tollera file con colonne diverse. Quando un singolo valore di testo fuori posto compromette il rilevamento dei tipi, leggi tutto come testo e converti in SQL.

[Leggere molti file CSV insieme](https://ducklocal.app/docs/it/data-sources#many-csv-files-at-once)

```sql
SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);
```

## Tutto ciò che sta attorno alla query

Una casella per le query è solo l'inizio. Queste sono le parti che la rendono uno spazio di lavoro.

- `.csv .tsv .txt`: delimitatore, intestazione e tipi rilevati da DuckDB
- `.csv.gz`: anche i file gzip si aprono come dati
- `data/*.csv`: apri ogni file che corrisponde a un pattern
- `folder/`: apri ogni file di dati in una cartella
- `Panoramica`: nulli, valori distinti, intervallo e distribuzione per colonna
- `Grafici`: grafici a barre, a linee, a dispersione, a torta e mappe da un risultato
- `Esporta Parquet`: converti dati CSV in Parquet
- `ducklocal query`: lo stesso SQL da un terminale, con output JSON

## Il tuo CSV non lascia mai il tuo computer

Gli strumenti CSV online richiedono un caricamento. DuckLocal è un'app desktop con DuckDB integrato: legge il file dal suo percorso, non lo copia né lo modifica e non richiede account.

Le aggregazioni operano su ogni riga del file. La griglia mostra fino a 100.000 righe di un risultato e un'esportazione scrive il risultato completo.

- Nessun caricamento e nessun servizio cloud DuckLocal
- Nessun server di database da installare
- Nessun account e nessuna telemetria
- Il file di origine non viene mai modificato
- Open source con licenza Apache-2.0

## Interroga i CSV dalla riga di comando

Lo stesso binario funziona senza finestra: `ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"` stampa il risultato come JSON, per script e agenti AI.

**Lavori con un agente AI?** Una CLI headless con output JSON limitato permette a un agente di ispezionare prima lo schema e poi interrogare. [Scopri SQL per agenti AI](https://ducklocal.app/it/use-cases/ai-agent-sql/)

## Domande su CSV e SQL

**Devo importare prima un file CSV in un database?**

No. DuckLocal crea una vista sul file e DuckDB lo legge sul posto. Il file non viene copiato, convertito o modificato, e rimuovere la vista lascia il file intatto.

**Posso fare join di più file CSV in un'unica query?**

Sì. Ogni file che apri diventa una vista a sé, quindi un `JOIN` tra due file CSV è SQL ordinario. Puoi anche fare join di CSV con Parquet, JSON, fogli Excel e tabelle DuckDB.

**Quale dialetto SQL usa DuckLocal?**

SQL DuckDB, che è vicino a PostgreSQL e aggiunge funzionalità analitiche come le funzioni finestra, `PIVOT` e la lettura diretta dei file con `read_csv`.

**E se il tipo di una colonna viene rilevato in modo errato?**

DuckDB deduce i tipi da un campione del file. Quando una colonna richiede una gestione diversa, leggila con `read_csv(..., all_varchar = true)` e convertila con `try_cast` nella tua query.

**Posso convertire un file CSV in Parquet?**

Sì. Esegui `SELECT * FROM` sulla vista e scegli Esporta Parquet. L'esportazione riesegue la query e scrive ogni riga.

## Link

- [Scarica DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Prova il tutorial di 10 minuti](https://ducklocal.app/docs/it/tutorial)
- [Apri il tutorial](https://ducklocal.app/docs/it/tutorial)
- [Analisi dei dati locali](https://ducklocal.app/it/use-cases/local-data-analysis/)
- [Visualizzatore Parquet](https://ducklocal.app/it/use-cases/parquet-viewer/)
- [DuckDB GUI](https://ducklocal.app/it/use-cases/duckdb-gui/)

Fonte: https://ducklocal.app/it/use-cases/query-csv-with-sql/
