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.

Gratis y de código abierto para macOS, Windows y Linux. Sin cuenta. Sin telemetría.

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 · Resultados y gráficos

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

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 .txtDelimitador, cabecera y tipos detectados por DuckDB
  • .csv.gzLos archivos con gzip también se abren como datos
  • data/*.csvAbre todos los archivos que coincidan con un patrón
  • folder/Abre todos los archivos de datos de una carpeta
  • ResumenNulos, valores distintos, rango y distribución por columna
  • GráficosGráficos de barras, líneas, dispersión, sectores y mapas a partir de un resultado
  • Exportar a ParquetConvierte datos CSV a Parquet
  • ducklocal queryEl 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.

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.

Ejecuta SQL sobre tu propio CSV

Descarga DuckLocal y sigue el tutorial con su CSV de ejemplo: de archivo a gráfico en unos diez minutos.