Ir al contenido

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:

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

Tiene cinco columnas:

ColumnaTipoEjemplo
dateDATE2026-09-01
channelVARCHARWeb, Mobile app, Store, Phone
regionVARCHARNorth, South, East, West
ordersBIGINT72
revenueDOUBLE4181.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 ⌘↵:

sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
channelrevenue
Mobile app290549.76
Web289544.8
Store240067.6
Phone82511.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:

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

Publicado bajo la licencia Apache-2.0.