De um arquivo CSV a um resultado
O arquivo fica onde está. O DuckLocal o lê no próprio local.
Solte o arquivo
sales.csvse torna uma view chamadasales. Arquivos separados por tabulação.tsv, arquivos.txte arquivos.csv.gzcompactados com gzip funcionam da mesma forma.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.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.
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.
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 .txtDelimitador, cabeçalho e tipos detectados pelo DuckDB
- .csv.gzArquivos compactados com gzip também abrem como dados
- data/*.csvAbra todos os arquivos que correspondem a um padrão
- folder/Abra todos os arquivos de dados em um diretório
- Visão geralNulos, valores distintos, intervalo e distribuição por coluna
- GráficosGráficos de barras, linhas, dispersão, pizza e mapa a partir de um resultado
- Exportar ParquetConverta dados CSV em Parquet
- ducklocal queryO 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.
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
JOINentre 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,
PIVOTe leitura de arquivos diretamente comread_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 comtry_castna sua consulta. - Posso converter um arquivo CSV em Parquet?
- Sim. Execute
SELECT * FROMna view e escolha Exportar Parquet. A exportação executa a consulta novamente e grava todas as linhas.
Relacionados: Análise de dados locais · Visualizador de Parquet · GUI do DuckDB · Consultar Excel com SQL · Consultar JSON com SQL
Execute SQL no seu próprio CSV
Baixe o DuckLocal e siga o tutorial com o CSV de exemplo: do arquivo ao gráfico em cerca de dez minutos.