---
title: Consulte arquivos CSV com SQL, sem configurar banco de dados | DuckLocal
description: "Execute SQL em arquivos CSV sem importá-los para um banco de dados. O DuckLocal lê CSV no próprio local com DuckDB: faça joins, agregue, gere gráficos e exporte para Parquet. Gratuito e local."
image: https://ducklocal.app/og-image.jpg
language: pt
---

# Consulte arquivos CSV com SQL

Solte um arquivo CSV no DuckLocal e ele se torna uma tabela com o nome do arquivo. O DuckDB descobre o delimitador, o cabeçalho e os tipos das colunas, então você pode fazer `SELECT`, `JOIN` e `GROUP BY` imediatamente. Não há etapa de importação nem `CREATE TABLE`, e arquivos grandes demais para uma planilha continuam a uma consulta de distância.

## De um arquivo CSV a um resultado

O arquivo fica onde está. O DuckLocal o lê no próprio local.

1. **Solte o arquivo.** `sales.csv` se torna uma view chamada `sales`. Arquivos separados por tabulação `.tsv`, arquivos `.txt` e arquivos `.csv.gz` compactados com gzip funcionam da mesma forma.
2. **Escreva SQL sobre ele.** A barra lateral de esquema mostra as colunas e seus tipos inferidos, e o autocompletar os conhece. Use o dialeto SQL completo do DuckDB: joins, funções de janela, CTEs e `PIVOT`.
3. **Guarde a resposta.** Gere um gráfico do resultado, veja a distribuição de cada coluna ou exporte o resultado completo para CSV ou Parquet.

## Faça join de arquivos CSV como tabelas

Abra `orders.csv` e `customers.csv` juntos e cada um se torna sua própria view. Faça join deles em uma única instrução, ou faça join de um arquivo CSV com um arquivo Parquet, uma planilha Excel ou uma tabela em um banco de dados DuckDB.

[O editor SQL](https://ducklocal.app/docs/pt/sql-editor) · [Resultados e gráficos](https://ducklocal.app/docs/pt/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;
```

## Muitos arquivos, e alguns bagunçados

Leia uma pasta inteira de arquivos CSV como uma única tabela com `read_csv`. `union_by_name` tolera arquivos cujas colunas diferem. Quando um valor de texto perdido quebra a detecção de tipo, leia tudo como texto e faça a conversão em SQL.

[Lendo muitos arquivos CSV de uma vez](https://ducklocal.app/docs/pt/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);
```

## Tudo em volta da consulta

Uma caixa de consulta é o começo. Estas são as partes que a tornam um workspace.

- `.csv .tsv .txt`: Delimitador, cabeçalho e tipos detectados pelo DuckDB
- `.csv.gz`: Arquivos compactados com gzip também abrem como dados
- `data/*.csv`: Abra todos os arquivos que correspondem a um padrão
- `folder/`: Abra todos os arquivos de dados em um diretório
- `Visão geral`: Nulos, valores distintos, intervalo e distribuição por coluna
- `Gráficos`: Gráficos de barras, linhas, dispersão, pizza e mapa a partir de um resultado
- `Exportar Parquet`: Converta dados CSV em Parquet
- `ducklocal query`: O mesmo SQL a partir de um terminal, com saída JSON

## Seu CSV nunca sai do seu computador

Ferramentas CSV online precisam de upload. O DuckLocal é um app desktop com o DuckDB incorporado: ele lê o arquivo a partir do caminho, não o copia nem altera, e não precisa de conta.

As agregações percorrem todas as linhas do arquivo. A grade exibe até 100.000 linhas de um resultado, e uma exportação grava o resultado completo.

- Sem upload e sem serviço de nuvem do DuckLocal
- Sem servidor de banco de dados para instalar
- Sem conta e sem telemetria
- O arquivo de origem nunca é modificado
- Código aberto sob Apache-2.0

## Consulte CSV pela linha de comando

O mesmo binário roda sem uma janela: `ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"` imprime o resultado como JSON, para scripts e agentes de IA.

**Trabalhando com um agente de IA?** Uma CLI headless com saída JSON limitada permite que um agente inspecione o esquema primeiro e consulte depois. [Veja SQL para agentes de IA](https://ducklocal.app/pt/use-cases/ai-agent-sql/)

## Perguntas sobre CSV e SQL

**Preciso importar um arquivo CSV para um banco de dados primeiro?**

Não. O DuckLocal cria uma view sobre o arquivo e o DuckDB o lê no próprio local. O arquivo não é copiado, convertido ou alterado, e remover a view deixa o arquivo intacto.

**Posso fazer join de vários arquivos CSV em uma consulta?**

Sim. Cada arquivo que você abre se torna sua própria view, então um `JOIN` entre dois arquivos CSV é SQL comum. Você também pode fazer join de CSV com Parquet, JSON, planilhas Excel e tabelas DuckDB.

**Qual dialeto SQL o DuckLocal usa?**

SQL do DuckDB, que é próximo do PostgreSQL e adiciona recursos analíticos como funções de janela, `PIVOT` e leitura de arquivos diretamente com `read_csv`.

**E se o tipo de uma coluna for detectado incorretamente?**

O DuckDB infere os tipos a partir de uma amostra do arquivo. Quando uma coluna precisa de tratamento diferente, leia-a com `read_csv(..., all_varchar = true)` e converta-a com `try_cast` na sua consulta.

**Posso converter um arquivo CSV em Parquet?**

Sim. Execute `SELECT * FROM` na view e escolha Exportar Parquet. A exportação executa a consulta novamente e grava todas as linhas.

## Links

- [Baixar o DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Experimente o tutorial de 10 minutos](https://ducklocal.app/docs/pt/tutorial)
- [Abra o tutorial](https://ducklocal.app/docs/pt/tutorial)
- [Análise de dados locais](https://ducklocal.app/pt/use-cases/local-data-analysis/)
- [Visualizador de Parquet](https://ducklocal.app/pt/use-cases/parquet-viewer/)
- [GUI do DuckDB](https://ducklocal.app/pt/use-cases/duckdb-gui/)

Source: https://ducklocal.app/pt/use-cases/query-csv-with-sql/
