Paneles SQL que puedes leer, comparar y revisar

Un panel de DuckLocal es un archivo de texto .dash: fuentes de datos, consultas SQL de DuckDB y los gráficos que las dibujan. Se ejecuta en tu ordenador sobre tus archivos locales, vive en git como el código y lo puedes escribir tú o un agente de IA.

Sin servidor de BI, sin cuenta, sin subir datos. Gratis y de código abierto para macOS, Windows y Linux.

Un panel es un archivo corto

Los bloques source nombran archivos de datos, los bloques query contienen SQL y los bloques plot dicen cómo dibujar cada resultado. Un bloque filter hace que un clic en un gráfico filtre los demás. No hay funciones ni plantillas que aprender: solo SQL y unos pocos atributos.

Las rutas son relativas al archivo .dash, así que una carpeta con la especificación y sus datos funciona donde la copies.

Todos los bloques y 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
}

Los gráficos que necesita un panel

Gráficos habituales, cifras y mapas, distribuidos en una cuadrícula de 12 columnas.

  • line · areaSeries temporales, hasta 12 series por gráfico
  • bar · stacked_barClasificaciones y partes de un total, con totales
  • scatter · histogramRelaciones y distribuciones
  • heatmapDía de la semana por hora, región por mes
  • mapPuntos por latitud y longitud, con tamaño y color
  • timelineEventos a su distancia real en el tiempo, por carriles
  • cardUna cifra, con su variación, buena o mala
  • table · textFilas ordenables, títulos y notas

Revisa un panel como un documento

Pasa el cursor por un gráfico, haz clic en el bocadillo y escribe qué debería cambiar, por ejemplo «ordénalos, el canal más grande primero». Los hilos admiten respuestas y se pueden resolver, y un gráfico con hilos abiertos muestra cuántos tiene.

Un agente de IA lee los mismos hilos con ducklocal comments. Cada hilo indica su gráfico y las líneas de su bloque en el archivo. El agente edita la especificación, la valida y responde. La ventana abierta se redibuja en menos de un segundo y muestra la respuesta, marcada como Agent.

Revisar con comentarios · Lo que Claude Dashboards me enseñó sobre 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

Comprobado antes de que nadie lo abra

ducklocal check analiza el archivo, resuelve cada referencia y ejecuta cada consulta en modo de solo lectura. Después confirma que las columnas de cada gráfico existen en el resultado real, así que una errata, una conversión que falla o un glob que no encuentra nada se detecta en el terminal y no en una reunión.

Todos los problemas aparecen a la vez, uno por file:line: message, con códigos de salida que un script o un trabajo de CI pueden usar.

Validar un panel

  • Sintaxis, nombres y referencias comprobados
  • El SQL de cada consulta ejecutado en DuckDB
  • Columnas de los gráficos contrastadas con resultados reales
  • Filtros comprobados con un valor elegido
  • Consultas sin filas señaladas

Tus datos se quedan en local, el archivo viaja

Las consultas se ejecutan en el motor DuckDB integrado en DuckLocal, sobre archivos de tu disco o una base de datos DuckDB. Envía la carpeta a alguien y verá el mismo panel sobre su copia de los datos, sin nada que publicar ni espacio de trabajo que compartir.

Preguntas sobre paneles SQL

¿Qué es un archivo .dash?
Un archivo de texto que declara un panel como bloques: source nombra archivos de datos, query contiene una instrucción SQL de DuckDB, plot dibuja un resultado y filter hace que un clic en un gráfico filtre los demás. No hay código que escribir.
¿Un panel necesita un servidor o una cuenta de BI?
No. DuckLocal abre el archivo y ejecuta sus consultas con el motor DuckDB integrado en la aplicación, en tu ordenador. Los archivos de datos se quedan donde están.
¿Qué gráficos hay disponibles?
Líneas, barras, barras apiladas, áreas, dispersión, sectores, mapas de calor, histogramas, mapas y líneas de tiempo, además de tablas, tarjetas numéricas con indicador de variación y paneles de texto, en una cuadrícula de 12 columnas.
¿Puede un agente de IA crear o cambiar un panel?
Sí. Un agente escribe o edita el archivo .dash, ejecuta ducklocal check para confirmar que cada consulta funciona y que existen las columnas de cada gráfico, y responde a los comentarios de revisión con ducklocal comments. La ventana abierta se redibuja en menos de un segundo.
¿Puedo guardar los paneles en git?
Sí. Un archivo .dash es texto corto, así que se compara y se revisa como el código. Los comentarios de revisión se guardan en un archivo aparte, NAME.dash.comments.json, que puedes dejar fuera del control de versiones.

Abre el panel de ejemplo

Descarga DuckLocal, guarda juntos los archivos sales.csv y sales.dash del tutorial y suelta el panel en la ventana.