---
title: "Painéis SQL locais como arquivos de texto | DuckLocal"
description: "Crie painéis do DuckDB como arquivos de texto .dash: consultas SQL, gráficos, cartões, mapas e filtros cruzados que rodam no seu computador, são revisados no git e que um agente de IA pode editar e validar."
image: https://ducklocal.app/og-image.jpg?v=2
language: pt
---

# Painéis SQL que você pode ler, comparar e revisar

Um painel do DuckLocal é um arquivo de texto `.dash`: fontes de dados, consultas SQL do DuckDB e os gráficos que as desenham. Ele roda no seu computador sobre seus arquivos locais, fica no git como código e pode ser escrito por você ou por um agente de IA.

Sem servidor de BI, sem conta, sem envio de dados. Gratuito e de código aberto para macOS, Windows e Linux.

- Arquivos de texto .dash
- Gráficos, cartões, mapas, tabelas
- Filtro cruzado com um clique
- Validado com ducklocal check

## Um painel é um arquivo curto

Blocos `source` indicam arquivos de dados, blocos `query` guardam SQL e blocos `plot` dizem como desenhar cada resultado. Um bloco `filter` faz com que um clique em um gráfico filtre os outros. Não há funções nem modelos para aprender, só SQL e alguns atributos.

Os caminhos são relativos ao arquivo `.dash`, então uma pasta com a especificação e os dados funciona onde quer que você a copie.

[Todos os blocos e atributos](https://ducklocal.app/docs/pt/dashboards#blocks)

```hcl
source "orders" {
  path = "orders.csv"
}

query "revenue" {
  sql = <<SQL
    SELECT channel, sum(amount) AS total
    FROM orders
    GROUP BY channel
    ORDER BY total DESC
  SQL
}

plot "revenue" {
  type  = "bar"
  query = query.revenue
  x     = channel
  y     = total
}
```

## Os gráficos de que um painel precisa

Gráficos comuns, números e mapas, organizados em uma grade de 12 colunas.

- **line · area**Séries temporais, até 12 séries por gráfico
- **bar · stacked_bar**Rankings e partes de um todo, com totais
- **scatter · histogram**Relações e distribuições
- **heatmap**Dia da semana por hora, região por mês
- **map**Pontos por latitude e longitude, com tamanho e cor
- **timeline**Eventos na distância real no tempo, em faixas
- **card**Um número, com sua variação, boa ou ruim
- **table · text**Linhas ordenáveis, títulos e notas
[Tipos de gráfico e opções →](https://ducklocal.app/docs/pt/dashboards#plot-types)

## Revise um painel como um documento

Passe o cursor sobre um gráfico, clique no balão e escreva o que deve mudar, por exemplo *“ordene, o maior canal primeiro”*. As conversas aceitam respostas e podem ser resolvidas, e um gráfico com conversas abertas mostra quantas são.

Um agente de IA lê as mesmas conversas com `ducklocal comments`. Cada conversa indica seu gráfico e as linhas do bloco dele no arquivo. O agente edita a especificação, valida e responde. A janela aberta se redesenha em menos de um segundo e mostra a resposta, marcada como **Agent**.

[Revisão com comentários](https://ducklocal.app/docs/pt/dashboards#review-with-comments) · [O que o Claude Dashboards me ensinou sobre o DuckLocal](https://ducklocal.app/pt/blog/claude-dashboards-ducklocal/)

```bash
ducklocal comments sales.dash
{"open":1, "threads":[{"id":"c1",
  "plot":"revenue_by_channel",
  "plot_lines":[68,75], ...}]}

ducklocal check sales.dash
ducklocal comments sales.dash --reply c1 \
  --text "Sorted by revenue, descending" --resolve
```

## Verificado antes que alguém abra

`ducklocal check` analisa o arquivo, resolve cada referência e executa cada consulta em modo somente leitura. Depois confirma que as colunas de cada gráfico existem no resultado real, então um erro de digitação, uma conversão que falha ou um glob que não encontra nada aparece no terminal, e não na reunião.

Todos os problemas são listados de uma vez, um `file:line: message` cada, com códigos de saída que um script ou um job de CI pode usar.

[Validar um painel](https://ducklocal.app/docs/pt/dashboards#validate-a-dashboard)

- Sintaxe, nomes e referências verificados
- O SQL de cada consulta executado no DuckDB
- Colunas dos gráficos conferidas com resultados reais
- Filtros verificados com um valor escolhido
- Consultas sem linhas sinalizadas

## Seus dados ficam locais, o arquivo viaja

As consultas rodam no motor DuckDB dentro do DuckLocal, sobre arquivos do seu disco ou um banco de dados DuckDB. Envie a pasta para alguém e essa pessoa verá o mesmo painel sobre a cópia dela dos dados, sem nada para publicar nem espaço de trabalho para compartilhar.

> **Começando com uma única consulta?** Qualquer resultado do editor SQL pode virar gráfico na hora. Escreva um arquivo `.dash` quando um conjunto de gráficos valer a pena guardar. [Resultados e gráficos →](https://ducklocal.app/docs/pt/results-and-charts)

## Perguntas sobre painéis SQL

**O que é um arquivo .dash?** Um arquivo de texto que declara um painel como blocos: `source` indica arquivos de dados, `query` guarda uma instrução SQL do DuckDB, `plot` desenha um resultado e `filter` faz com que um clique em um gráfico filtre os outros. Não há código para escrever.

**Um painel precisa de servidor ou de conta de BI?** Não. O DuckLocal abre o arquivo e executa as consultas com o motor DuckDB dentro do app, no seu computador. Os arquivos de dados ficam onde estão.

**Quais gráficos estão disponíveis?** Linhas, barras, barras empilhadas, área, dispersão, pizza, mapa de calor, histograma, mapa e linha do tempo, além de tabelas, cartões numéricos com indicador de variação e painéis de texto, em uma grade de 12 colunas.

**Um agente de IA pode criar ou alterar um painel?** Sim. Um agente escreve ou edita o arquivo .dash, executa `ducklocal check` para confirmar que cada consulta roda e que as colunas de cada gráfico existem, e responde aos comentários de revisão com `ducklocal comments`. A janela aberta se redesenha em menos de um segundo.

**Posso manter os painéis no git?** Sim. Um arquivo .dash é um texto curto, que se compara e se revisa como código. Os comentários de revisão ficam em um arquivo separado, `NAME.dash.comments.json`, que você pode deixar fora do controle de versão.

Relacionados: [SQL para agentes de IA](https://ducklocal.app/pt/use-cases/ai-agent-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/) · [Consultar CSV com SQL](https://ducklocal.app/pt/use-cases/query-csv-with-sql/)

## Abra o painel de exemplo

Baixe o DuckLocal, salve lado a lado os arquivos `sales.csv` e `sales.dash` do tutorial e solte o painel na janela.

## Links

- [Baixar o DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Leia o guia de painéis](https://ducklocal.app/docs/pt/dashboards)
- [Veja o exemplo completo](https://ducklocal.app/docs/pt/dashboards#a-complete-example)

Source: https://ducklocal.app/pt/use-cases/sql-dashboards/
