---
title: GUI do DuckDB para Mac, Windows e Linux | DuckLocal
description: "Uma GUI gratuita e de código aberto para DuckDB: abra bancos de dados .duckdb e arquivos de dados em um app desktop nativo com editor SQL, navegador de esquema, gráficos, profiler e extensões."
image: https://ducklocal.app/og-image.jpg
language: pt
---

# Uma GUI nativa do DuckDB para o seu desktop

Abra um banco de dados `.duckdb`, ou uma pasta de arquivos CSV e Parquet, em um cliente desktop construído em torno do próprio DuckDB: um editor SQL ciente do esquema, uma grade de resultados, gráficos, um profiler de consultas e uma aba Extensões. Não há servidor para iniciar, driver para instalar nem string de conexão para escrever.

## O que você encontra na janela

As peças de um cliente de banco de dados, sem nada para conectar antes.

1. **Abra um banco de dados, ou apenas arquivos.** Um arquivo `.duckdb` é aberto como o banco de dados principal. Arquivos CSV, Parquet, JSON e Excel são abertos ao lado dele como views e tabelas, em memória ou dentro do banco de dados que você abriu.
2. **Escreva SQL com o catálogo ao alcance.** Navegue por tabelas e colunas na barra lateral de esquema, gere um `SELECT` a partir dela e deixe o autocompletar sugerir suas tabelas, colunas e funções do DuckDB. Abas, formatação e os comandos de ponto `.tables`, `.schema` e `.databases` também estão lá.
3. **Veja onde o tempo é gasto.** **Explain** mostra o plano sem executar a instrução. **Profile** a executa e mostra o tempo de cada operador e suas linhas estimadas versus reais.

## Consulte entre bancos de dados

Anexe outro arquivo DuckDB ou SQLite ao lado do banco de dados principal e faça joins entre eles, por exemplo um snapshot ao lado dos dados de hoje. Os anexos são somente leitura a menos que você diga o contrário, recebem um alias a partir do nome do arquivo e voltam na próxima inicialização.

[Como funcionam os bancos de dados anexados](https://ducklocal.app/docs/pt/data-sources#attached-databases) · [O editor SQL](https://ducklocal.app/docs/pt/sql-editor)

```sql
-- snap-2026-10-01.duckdb attached as snap_2026_10_01
SELECT t.id,
       t.amount,
       s.amount AS amount_last_week
FROM orders t
JOIN snap_2026_10_01.orders s USING (id);
```

## Construído em torno do motor DuckDB

O DuckLocal expõe o que o DuckDB pode fazer em vez de escondê-lo atrás de um driver de banco de dados genérico.

- `Explain`: O plano da consulta, sem executar a instrução
- `Profile`: Tempo por operador, linhas estimadas versus reais
- `Extensions`: Liste, instale, carregue e atualize extensões do DuckDB
- `ATTACH`: Bancos de dados DuckDB e SQLite lado a lado
- `s3://`: Armazenamento S3 e compatível com S3 via httpfs
- `Storage format`: Veja quais versões do DuckDB conseguem ler um arquivo de banco de dados
- `start_ui()`: Execute o notebook DuckDB UI na mesma instância
- `.dash`: Dashboards em texto simples com gráficos e filtragem cruzada

## Como ele difere de outros clientes DuckDB

O shell de linha de comando `duckdb` é o cliente de referência, e o DuckDB UI é um notebook que roda no seu navegador. Ferramentas de banco de dados de uso geral chegam ao DuckDB por meio de um driver e um perfil de conexão.

O DuckLocal é um único programa desktop com o motor dentro, então abrir um banco de dados é abrir um arquivo. Se você também quiser o notebook, o DuckDB UI roda dentro do DuckLocal com `CALL start_ui()`. [DuckDB UI vs DuckLocal](https://ducklocal.app/pt/blog/duckdb-ui-vs-ducklocal/) compara os dois em detalhes.

- Nenhum processo de servidor para iniciar ou parar
- Nenhum driver JDBC ou perfil de conexão
- Sem conta e sem telemetria
- Os arquivos de banco de dados que ele cria continuam legíveis pelo DuckDB 1.x
- Uma explicação clara quando um arquivo de banco de dados não abre

## Scripts e agentes de IA usam o mesmo motor

O mesmo binário roda sem uma janela. `ducklocal query` executa uma instrução SQL e imprime JSON, e `ducklocal schema` lista o que pode ser consultado.

**Trabalhando com um agente de IA?** Dê a ele uma CLI headless com saída JSON limitada e um fluxo de trabalho que começa pelo esquema. [Veja SQL para agentes de IA](https://ducklocal.app/pt/use-cases/ai-agent-sql/)

## Perguntas sobre a GUI do DuckDB

**Existe uma GUI oficial do DuckDB?**

O DuckDB distribui o DuckDB UI, um notebook que roda no seu navegador e é iniciado com `CALL start_ui()`. O DuckLocal é um app desktop independente de código aberto com o DuckDB incorporado; ele não é feito pelo projeto DuckDB. O DuckDB UI também pode rodar dentro do DuckLocal.

**Qual versão do DuckDB o DuckLocal usa?**

O DuckLocal incorpora o DuckDB 2.0. Um arquivo de banco de dados que ele cria é gravado no formato que o DuckDB 1.x também lê, e um arquivo que já está no formato DuckDB 2.0 é aberto e mantém esse formato.

**O DuckLocal pode abrir meu arquivo .duckdb existente?**

Sim. Abra-o como banco de dados principal ou anexe-o ao lado do que você tem aberto. Quando um arquivo foi gravado por um DuckDB mais novo do que o que está dentro do DuckLocal, o app avisa e fornece o SQL que o copia para um formato que consegue ler.

**Ele funciona com bancos de dados SQLite?**

Sim. Anexe um arquivo SQLite com Abrir → Anexar banco de dados… e consulte suas tabelas ao lado das suas tabelas DuckDB e arquivos de dados.

**O DuckLocal é gratuito?**

Sim. O DuckLocal é gratuito e de código aberto sob Apache-2.0. Ele roda no macOS 12 ou posterior em Apple silicon, Windows 10 de 64 bits ou posterior e Linux x86_64.

## Links

- [Baixar o DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Instale e execute sua primeira consulta](https://ducklocal.app/docs/pt/getting-started)
- [Leia o guia de fontes de dados](https://ducklocal.app/docs/pt/data-sources)
- [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/)
- [Consultar CSV com SQL](https://ducklocal.app/pt/use-cases/query-csv-with-sql/)

Source: https://ducklocal.app/pt/use-cases/duckdb-gui/
