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.
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
$ 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.
- 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:
sourceindica arquivos de dados,queryguarda uma instrução SQL do DuckDB,plotdesenha um resultado efilterfaz 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 checkpara confirmar que cada consulta roda e que as colunas de cada gráfico existem, e responde aos comentários de revisão comducklocal 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 · Análise de dados locais · Interface DuckDB · Consultar CSV com 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.