---
title: "Consulte arquivos Excel com SQL, cada planilha uma tabela | DuckLocal"
description: "Execute SQL do DuckDB em pastas de trabalho do Excel sem Excel nem banco de dados. Cada planilha de um arquivo .xlsx, .xls, .xlsb ou .ods vira uma tabela que você pode juntar com CSV e Parquet. Gratuito e local."
image: https://ducklocal.app/og-image.jpg?v=2
language: pt
---

# Consulte arquivos Excel com SQL

Abra uma pasta de trabalho no DuckLocal e cada planilha vira uma tabela. Junte planilhas entre si, com arquivos CSV e Parquet ou com um banco de dados DuckDB, e obtenha respostas que uma tabela dinâmica não dá. Sem instalar o Excel, sem servidor de banco de dados, sem enviar nada.

Gratuito e de código aberto para macOS, Windows e Linux. Sua pasta de trabalho é lida, nunca alterada.

- .xlsx .xls .xlsb .ods
- Cada planilha, uma tabela
- Tipos de coluna detectados
- Junções com CSV e Parquet

## Da pasta de trabalho à resposta

Arraste o arquivo ou abra pelo menu. Não há assistente de importação para ir clicando.

1. **Abra a pasta de trabalho.** A primeira planilha vira uma tabela com o nome do arquivo: `budget.xlsx` gera `budget`. As outras planilhas se chamam `{file}_{sheet}`, como `budget_actuals`. Planilhas vazias são ignoradas.
2. **Escreva SQL nas planilhas.** A barra lateral do esquema lista as colunas de cada planilha e os tipos detectados, e o preenchimento automático as conhece. Use junções, funções de janela, `PIVOT` e o resto do SQL do DuckDB.
3. **Guarde o resultado.** Transforme em gráfico, veja a distribuição de cada coluna ou exporte o resultado completo para CSV, para uma planilha, ou Parquet, para outras ferramentas.

## Junte planilhas, pastas de trabalho e arquivos

Uma busca entre planilhas que exigiria fórmulas `VLOOKUP` (PROCV) é um único `JOIN` em SQL. O mesmo vale entre duas pastas de trabalho ou entre uma planilha e um CSV exportado de outro sistema.

[O editor SQL](https://ducklocal.app/docs/pt/sql-editor) · [Consultar CSV com SQL](https://ducklocal.app/pt/use-cases/query-csv-with-sql/)

```sql
-- budget.xlsx: first sheet → budget,
-- sheet "actuals" → budget_actuals
SELECT b.department,
       b.planned,
       sum(a.amount)             AS spent,
       b.planned - sum(a.amount) AS remaining
FROM budget b
JOIN budget_actuals a USING (department)
GROUP BY b.department, b.planned
ORDER BY remaining;
```

## Como uma planilha vira uma tabela

A primeira linha é o cabeçalho. Cada coluna recebe o tipo mais estreito que comporta todas as suas células: inteiros viram `BIGINT`, uma mistura de inteiros e decimais `DOUBLE`, datas `TIMESTAMP` e valores verdadeiro/falso `BOOLEAN`. Qualquer outra mistura fica como `VARCHAR`, então nada se perde e você pode usar `TRY_CAST` no SQL.

[A importação de pastas de trabalho em detalhe](https://ducklocal.app/docs/pt/data-sources#supported-file-formats)

- Células vazias viram `NULL`
- Um cabeçalho vazio vira `column_1`, `column_2`…
- Um cabeçalho repetido ganha um sufixo: `amount`, `amount_2`
- Fórmulas chegam como valores
- O arquivo da pasta de trabalho nunca é gravado

## Uma cópia que você pode manter

Diferente de CSV e Parquet, que o DuckLocal lê no lugar, uma planilha é copiada para uma tabela quando você abre a pasta de trabalho. Se você alterar o arquivo no Excel, abra de novo e as tabelas serão substituídas.

Para manter as tabelas, abra primeiro um banco de dados `.duckdb` e depois a pasta de trabalho. As planilhas são salvas nesse banco, prontas para a próxima vez que você abri-lo e legíveis por qualquer cliente DuckDB.

> **Mais linhas do que cabem em uma planilha?** Uma planilha vai até 1.048.576 linhas. Para algo maior, exporte como CSV ou Parquet e consulte o arquivo diretamente. [Veja o visualizador de Parquet →](https://ducklocal.app/pt/use-cases/parquet-viewer/)

## Pastas de trabalho na linha de comando

`ducklocal schema` lista uma pasta de trabalho com suas planilhas, e `--stats` analisa a primeira planilha: nulos, valores distintos, intervalos e medianas por coluna. Um agente de IA consegue ver o que uma planilha contém antes de escrever qualquer SQL.

Para consultar planilhas a partir de um script ou de um agente, salve-as em um banco de dados pelo app como descrito acima e execute `ducklocal query --database` nesse arquivo.

[Leia o guia da CLI](https://ducklocal.app/docs/pt/cli) · [SQL para agentes de IA](https://ducklocal.app/pt/use-cases/ai-agent-sql/)

```bash
ducklocal schema budget.xlsx
ducklocal schema budget.xlsx --stats
ducklocal query --database budget.duckdb \
  --sql "SELECT department, sum(amount)
         FROM budget_actuals
         GROUP BY department"
```

## Perguntas sobre Excel e SQL

**Quais formatos de planilha o DuckLocal consegue consultar?** Pastas de trabalho do Excel `.xlsx`, `.xls` e `.xlsb`, e planilhas OpenDocument `.ods`. Cada planilha não vazia é importada como uma tabela própria.

**O DuckLocal altera minha pasta de trabalho?** Não. Ele lê o arquivo e copia cada planilha para uma tabela; a pasta de trabalho em si nunca é gravada. Se você editá-la depois no Excel, abra de novo para pegar as mudanças.

**As fórmulas vêm junto?** Os valores vêm. O DuckLocal lê os resultados que seu aplicativo de planilhas salvou no arquivo, não as fórmulas por trás deles, então uma coluna de totais chega como números.

**Posso exportar o resultado de volta para uma planilha?** Exporte qualquer resultado para CSV, que o Excel e qualquer outro aplicativo de planilhas abrem, ou para Parquet, para outras ferramentas de dados. O DuckLocal não grava arquivos .xlsx.

**O DuckLocal é uma alternativa ao Excel?** Para análise, sim: junções entre planilhas e arquivos, agregações e dados grandes demais para o limite de 1.048.576 linhas de uma planilha. Não é um editor de planilhas; você não digita em células nem escreve fórmulas.

Relacionados: [Consultar CSV com SQL](https://ducklocal.app/pt/use-cases/query-csv-with-sql/) · [Consultar JSON com SQL](https://ducklocal.app/pt/use-cases/query-json-with-sql/) · [Análise de dados locais](https://ducklocal.app/pt/use-cases/local-data-analysis/) · [Interface DuckDB](https://ducklocal.app/pt/use-cases/duckdb-gui/)

## Execute SQL na sua própria pasta de trabalho

Baixe o DuckLocal, solte uma planilha e junte as abas em uma única consulta.

## Links

- [Baixar o DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Veja como as pastas de trabalho são lidas](https://ducklocal.app/docs/pt/data-sources#supported-file-formats)
- [Instale e execute uma primeira consulta](https://ducklocal.app/docs/pt/getting-started)

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