https://github.com/dotted-ai/parquet-query
DuckDB-WASM to import a folder (parquet/csv/json/ndjson) and execute SQL queries.
https://github.com/dotted-ai/parquet-query
duckdb parquet parquet-files sql
Last synced: about 1 month ago
JSON representation
DuckDB-WASM to import a folder (parquet/csv/json/ndjson) and execute SQL queries.
- Host: GitHub
- URL: https://github.com/dotted-ai/parquet-query
- Owner: dotted-ai
- Created: 2025-12-15T16:41:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-07T19:29:06.000Z (5 months ago)
- Last Synced: 2026-03-05T11:48:16.838Z (3 months ago)
- Topics: duckdb, parquet, parquet-files, sql
- Language: TypeScript
- Homepage:
- Size: 1.47 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Parquet Query (React + DuckDB)
App React no browser usando DuckDB-WASM para importar uma pasta (parquet/csv/json/ndjson) e executar queries SQL.
## Requisitos
- Node.js 18+
- Navegador Chromium (Chrome/Edge) recomendado para **selecionar pasta** via File System Access API
- Em outros navegadores, o app usa fallback via ``
## Como rodar
```bash
npm install
npm run dev
```
Abra a URL mostrada pelo Vite.
## Como usar
1. Clique em **Selecionar pasta** e escolha uma pasta com arquivos (`.parquet`, `.csv`, `.json`, `.ndjson`)
2. (Opcional) Preencha **Nome da tabela** para criar uma VIEW com **todos os `.parquet`** importados
3. Rode queries consultando os arquivos diretamente pelo caminho importado ou pela tabela:
```sql
SELECT * FROM 'minha_pasta/arquivo.parquet' LIMIT 50;
SELECT COUNT(*) FROM 'minha_pasta/arquivo.csv';
SELECT COUNT(*) FROM minha_tabela;
```
## Exportar CSV
Rode uma query e clique em **Exportar CSV** para baixar o resultado em `.csv`.
## Observações
- O DuckDB-WASM (worker/wasm) é baixado do jsDelivr na primeira vez (precisa de internet).
- Os arquivos são carregados para a memória do browser (evite pastas muito grandes).
- A UI mostra no máximo 200 linhas por query.