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.
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
$ 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.
- 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:
sourcenombra archivos de datos,querycontiene una instrucción SQL de DuckDB,plotdibuja un resultado yfilterhace 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 checkpara confirmar que cada consulta funciona y que existen las columnas de cada gráfico, y responde a los comentarios de revisión conducklocal 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.
Relacionado: SQL para agentes de IA · Análisis de datos locales · Interfaz DuckDB · Consultar CSV con SQL
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.