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.

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

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 · areaSéries temporais, até 12 séries por gráfico
  • bar · stacked_barRankings e partes de um todo, com totais
  • scatter · histogramRelações e distribuições
  • heatmapDia da semana por hora, região por mês
  • mapPontos por latitude e longitude, com tamanho e cor
  • timelineEventos na distância real no tempo, em faixas
  • cardUm número, com sua variação, boa ou ruim
  • table · textLinhas ordenáveis, títulos e notas

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 · O que o Claude Dashboards me ensinou sobre o DuckLocal

Terminal
$ 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

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

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.

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.