---
title: Consultar archivos CSV con SQL, sin base de datos | DuckLocal
description: "Ejecuta SQL sobre archivos CSV sin importarlos a una base de datos. DuckLocal lee el CSV donde está con DuckDB: une, agrega, dibuja gráficos y exporta a Parquet. Gratis y local."
image: https://ducklocal.app/og-image.jpg
language: es
---

# Consulta archivos CSV con SQL

Arrastra un archivo CSV a DuckLocal y se convierte en una tabla con el nombre del archivo. DuckDB deduce el delimitador, la cabecera y los tipos de las columnas, así que puedes hacer `SELECT`, `JOIN` y `GROUP BY` de inmediato. No hay paso de importación ni `CREATE TABLE`, y los archivos demasiado grandes para una hoja de cálculo siguen a una sola consulta de distancia.

## De un archivo CSV a un resultado

El archivo se queda donde está. DuckLocal lo lee ahí mismo.

1. **Arrastra el archivo.** `sales.csv` se convierte en una vista llamada `sales`. Los archivos `.tsv` separados por tabulaciones, los archivos `.txt` y los `.csv.gz` comprimidos con gzip funcionan igual.
2. **Escribe SQL sobre él.** La barra lateral de esquema muestra las columnas y sus tipos deducidos, y el autocompletado los conoce. Usa todo el dialecto DuckDB SQL: uniones, funciones de ventana, CTE y `PIVOT`.
3. **Quédate con la respuesta.** Convierte el resultado en un gráfico, mira la distribución de cada columna o exporta el resultado completo a CSV o Parquet.

## Une archivos CSV como si fueran tablas

Abre `orders.csv` y `customers.csv` a la vez y cada uno se convierte en su propia vista. Únelos en una sola sentencia, o une un archivo CSV con un archivo Parquet, una hoja de Excel o una tabla de una base de datos DuckDB.

[El editor SQL](https://ducklocal.app/docs/es/sql-editor) · [Resultados y gráficos](https://ducklocal.app/docs/es/results-and-charts)

```sql
SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;
```

## Muchos archivos, y desordenados

Lee una carpeta entera de archivos CSV como una sola tabla con `read_csv`. `union_by_name` tolera archivos cuyas columnas difieren. Cuando un valor de texto suelto rompe la detección de tipos, léelo todo como texto y conviértelo en SQL.

[Leer muchos archivos CSV a la vez](https://ducklocal.app/docs/es/data-sources#many-csv-files-at-once)

```sql
SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);
```

## Todo lo que rodea a la consulta

Una caja de consulta es solo el principio. Estas son las piezas que la convierten en un espacio de trabajo.

- `.csv .tsv .txt`: Delimitador, cabecera y tipos detectados por DuckDB
- `.csv.gz`: Los archivos con gzip también se abren como datos
- `data/*.csv`: Abre todos los archivos que coincidan con un patrón
- `folder/`: Abre todos los archivos de datos de una carpeta
- `Resumen`: Nulos, valores distintos, rango y distribución por columna
- `Gráficos`: Gráficos de barras, líneas, dispersión, sectores y mapas a partir de un resultado
- `Exportar a Parquet`: Convierte datos CSV a Parquet
- `ducklocal query`: El mismo SQL desde un terminal, con salida JSON

## Tu CSV nunca sale de tu ordenador

Las herramientas CSV en línea exigen subir el archivo. DuckLocal es una app de escritorio con DuckDB integrado: lee el archivo desde su ruta, no lo copia ni lo modifica y no necesita cuenta.

Las agregaciones se ejecutan sobre todas las filas del archivo. La cuadrícula muestra hasta 100.000 filas de un resultado, y una exportación escribe el resultado completo.

- Sin subidas y sin servicio en la nube de DuckLocal
- Sin servidor de base de datos que instalar
- Sin cuenta y sin telemetría
- El archivo de origen nunca se modifica
- Código abierto bajo Apache-2.0

## Consulta CSV desde la línea de comandos

El mismo binario se ejecuta sin ventana: `ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"` imprime el resultado como JSON, para scripts y agentes de IA.

**¿Trabajas con un agente de IA?** Una CLI sin interfaz y con salida JSON acotada permite que un agente inspeccione primero el esquema y consulte después. [Ver SQL para agentes de IA](https://ducklocal.app/es/use-cases/ai-agent-sql/)

## Preguntas sobre CSV y SQL

**¿Tengo que importar un archivo CSV a una base de datos primero?**

No. DuckLocal crea una vista sobre el archivo y DuckDB lo lee donde está. El archivo no se copia, ni se convierte, ni se modifica, y quitar la vista lo deja intacto.

**¿Puedo unir varios archivos CSV en una sola consulta?**

Sí. Cada archivo que abres se convierte en su propia vista, así que un `JOIN` entre dos archivos CSV es SQL corriente. También puedes unir CSV con Parquet, JSON, hojas de Excel y tablas de DuckDB.

**¿Qué dialecto SQL usa DuckLocal?**

DuckDB SQL, que se parece a PostgreSQL y añade funciones analíticas como las funciones de ventana, `PIVOT` y la lectura directa de archivos con `read_csv`.

**¿Y si el tipo de una columna se detecta mal?**

DuckDB deduce los tipos a partir de una muestra del archivo. Cuando una columna necesita otro tratamiento, léela con `read_csv(..., all_varchar = true)` y conviértela con `try_cast` en tu consulta.

**¿Puedo convertir un archivo CSV a Parquet?**

Sí. Ejecuta `SELECT * FROM` sobre la vista y elige Exportar a Parquet. La exportación vuelve a ejecutar la consulta y escribe todas las filas.

## Links

- [Descargar DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Prueba el tutorial de 10 minutos](https://ducklocal.app/docs/es/tutorial)
- [Abrir el tutorial](https://ducklocal.app/docs/es/tutorial)
- [Análisis de datos locales](https://ducklocal.app/es/use-cases/local-data-analysis/)
- [Visor de Parquet](https://ducklocal.app/es/use-cases/parquet-viewer/)
- [DuckDB GUI](https://ducklocal.app/es/use-cases/duckdb-gui/)

Source: https://ducklocal.app/es/use-cases/query-csv-with-sql/
