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.

Gratuito e de código aberto para macOS, Windows e Linux. Sem conta. Sem telemetria.

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 · Resultados e gráficos

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

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 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.

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.