# Tus primeros 10 minutos

> Un tutorial de diez minutos de DuckLocal con un CSV de ejemplo: consúltalo con SQL, dibuja los resultados, expórtalos y haz la misma pregunta desde la CLI.

Source: https://ducklocal.app/docs/es/tutorial

Un recorrido guiado: abre un archivo pequeño de ventas, ejecuta unas cuantas consultas,
dibuja las respuestas y exporta los resultados. Da por hecho que DuckLocal está instalado;
si no es así, empieza por [Primeros pasos](getting-started.md).

## 1. Consigue el archivo de ejemplo {#sample-file}

Descarga [sales.csv](https://ducklocal.app/docs/samples/sales.csv), que contiene dos semanas de pedidos ficticios
en 224 filas. También puedes descargarlo desde el terminal:

```bash
curl -LO https://ducklocal.app/docs/samples/sales.csv
```

Tiene cinco columnas:

| Columna | Tipo | Ejemplo |
| --- | --- | --- |
| `date` | DATE | `2026-09-01` |
| `channel` | VARCHAR | `Web`, `Mobile app`, `Store`, `Phone` |
| `region` | VARCHAR | `North`, `South`, `East`, `West` |
| `orders` | BIGINT | `72` |
| `revenue` | DOUBLE | `4181.04` |

No tuviste que decirle nada de eso a DuckLocal: DuckDB lee la cabecera e
infiere los tipos por su cuenta.

## 2. Ábrelo

Arrastra `sales.csv` a la ventana de DuckLocal. (O haz clic en **Abrir archivos…**, o ejecuta
`ducklocal sales.csv` si [añadiste el comando](getting-started.md#add-command).)

Una notificación confirma **Vista sales creada.** En la barra lateral, **Archivos
locales** ahora lista `sales` con sus 224 filas; despliégala para ver las columnas y
sus tipos.

## 3. Mira las filas

En la barra lateral, haz clic en el botón de reproducción junto a `sales`. El editor se
rellena con un `SELECT * … LIMIT 100` para ella: pulsa **⌘↵** para ejecutarlo.

La cuadrícula bajo el editor muestra las filas. Prueba el cuadro de filtro que hay
encima: escribe `Store` y pulsa Enter para quedarte solo con las filas que lo mencionan. El filtro
actúa sobre las filas ya cargadas y nunca vuelve a consultar.

## 4. Haz una pregunta

Sustituye el SQL por esto y pulsa **⌘↵**:

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

| channel | revenue |
| --- | --- |
| Mobile app | 290549.76 |
| Web | 289544.8 |
| Store | 240067.6 |
| Phone | 82511.2 |

Ahora cambia el panel de resultados de **Resultados** a **Gráfico**. Como la primera
columna es texto, obtienes una barra por canal, dimensionada por la primera columna numérica.

::: tip Autocompletado
Mientras escribes, el editor ofrece primero nombres de tablas y columnas de la barra
lateral, luego funciones de DuckDB y palabras clave de SQL: escribe `rev` y `revenue` es
la primera sugerencia.
:::

## 5. Dibuja una tendencia

Los gráficos se dibujan a partir de las filas exactamente como las devuelve la consulta, así que da forma
al resultado como quieres que se represente. Una columna por canal da una línea
por canal:

```sql
SELECT
  date,
  round(sum(revenue) FILTER (WHERE channel = 'Web'), 2)        AS web,
  round(sum(revenue) FILTER (WHERE channel = 'Mobile app'), 2) AS mobile,
  round(sum(revenue) FILTER (WHERE channel = 'Store'), 2)      AS store
FROM sales
GROUP BY date
ORDER BY date;
```

`FILTER (WHERE …)` agrega solo las filas que coinciden (sintaxis de DuckDB).

Con una fecha en la primera columna, **Gráfico** dibuja un gráfico de área a lo largo del tiempo,
con una serie por columna numérica. [Resultados y gráficos](results-and-charts.md)
cubre las reglas y los límites.

## 6. Exporta la respuesta

**Exportar sobrescribe un archivo existente sin preguntar.** Con la tendencia aún
en el panel de resultados, haz clic en **Exportar CSV**. El diálogo sugiere
`~/Desktop/export.csv`; cambia la ruta si quieres y confirma.

Exportar vuelve a ejecutar la consulta, así que el archivo contiene el resultado completo, no solo lo que
se ve en la cuadrícula.

## 7. Encuéntralo de nuevo mañana

Abre la pestaña **Historial** de la barra lateral: todas las consultas que ejecutaste están ahí, incluidas
las que fallaron. Al hacer clic en una se sustituye lo que el editor tiene en ese momento:
haz clic en una entrada para devolver esa consulta al editor.

Cierra DuckLocal y vuelve a iniciarlo. `sales` sigue en **Archivos locales**:
los archivos abiertos se recuerdan por su ruta y se vuelven a leer en cada inicio, así que una edición
del CSV se ve la próxima vez que lo consultes.

## 8. Extra: la misma pregunta desde un terminal

Si añadiste el comando `ducklocal`, la CLI responde sin abrir una
ventana: práctico para scripts y para agentes de IA:

```bash
ducklocal query --format md --sql "
  SELECT channel, round(sum(revenue), 2) AS revenue
  FROM 'sales.csv' GROUP BY channel ORDER BY revenue DESC"
```

Omite `--format md` para obtener JSON estructurado. La [guía de la CLI](cli.md) y la
habilidad de agente oficial —un paquete de habilidades que los asistentes de programación con IA
pueden invocar— son el punto de partida.

## Siguiente

- Pruébalo con datos reales: 3,5 millones de viajes en taxi, consultados por HTTPS — consulta [Ejemplo: viajes en taxi de Nueva York](example-nyc-taxi.md)
- Apunta DuckLocal a tus propios archivos o carpetas — consulta [Fuentes de datos](data-sources.md)
- Consulta archivos en almacenamiento compatible con S3 — consulta [S3 y httpfs](s3.md)
- Crea un panel de consultas guardadas — consulta [Paneles (.dash)](dashboards.md)
