---
title: "Paneles SQL locales como archivos de texto | DuckLocal"
description: "Crea paneles de DuckDB como archivos de texto .dash: consultas SQL, gráficos, tarjetas, mapas y filtros cruzados que se ejecutan en tu ordenador, se revisan en git y que un agente de IA puede editar y validar."
image: https://ducklocal.app/og-image.jpg?v=2
language: es
---

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

- Archivos de texto .dash
- Gráficos, tarjetas, mapas, tablas
- Filtrado cruzado con un clic
- Validado con ducklocal check

## 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](https://ducklocal.app/docs/es/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
}
```

## Los gráficos que necesita un panel

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

- **line · area**Series temporales, hasta 12 series por gráfico
- **bar · stacked_bar**Clasificaciones y partes de un total, con totales
- **scatter · histogram**Relaciones y distribuciones
- **heatmap**Día de la semana por hora, región por mes
- **map**Puntos por latitud y longitud, con tamaño y color
- **timeline**Eventos a su distancia real en el tiempo, por carriles
- **card**Una cifra, con su variación, buena o mala
- **table · text**Filas ordenables, títulos y notas
[Tipos de gráfico y opciones →](https://ducklocal.app/docs/es/dashboards#plot-types)

## 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](https://ducklocal.app/docs/es/dashboards#review-with-comments) · [Lo que Claude Dashboards me enseñó sobre DuckLocal](https://ducklocal.app/es/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
```

## 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](https://ducklocal.app/docs/es/dashboards#validate-a-dashboard)

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

> **¿Empiezas con una sola consulta?** Cualquier resultado del editor SQL se puede graficar al momento. Escribe un archivo `.dash` cuando un conjunto de gráficos merezca la pena conservarse. [Resultados y gráficos →](https://ducklocal.app/docs/es/results-and-charts)

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

Relacionado: [SQL para agentes de IA](https://ducklocal.app/es/use-cases/ai-agent-sql/) · [Análisis de datos locales](https://ducklocal.app/es/use-cases/local-data-analysis/) · [Interfaz DuckDB](https://ducklocal.app/es/use-cases/duckdb-gui/) · [Consultar CSV con SQL](https://ducklocal.app/es/use-cases/query-csv-with-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.

## Enlaces

- [Descargar DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Leer la guía de paneles](https://ducklocal.app/docs/es/dashboards)
- [Ver el ejemplo completo](https://ducklocal.app/docs/es/dashboards#a-complete-example)

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