Tus primeros 10 minutos
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.
1. Consigue el archivo de ejemplo
Descarga sales.csv, que contiene dos semanas de pedidos ficticios en 224 filas. También puedes descargarlo desde el terminal:
curl -LO https://ducklocal.app/docs/samples/sales.csvTiene 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.)
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 ⌘↵:
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.
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:
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 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:
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 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
- Apunta DuckLocal a tus propios archivos o carpetas — consulta Fuentes de datos
- Consulta archivos en almacenamiento compatible con S3 — consulta S3 y httpfs
- Crea un panel de consultas guardadas — consulta Paneles (.dash)
