Repolode
Enviar
neilotoole

neilotoole/sq

Herramienta de línea de comandos para consultar y combinar bases de datos SQL y archivos como CSV, Excel y JSON con sintaxis tipo jq o SQL.

Ver en GitHubSitio web
Estrellas
2,573
Forks
43
Issues abiertos
87
Último commit
ayer

¿Qué es?

sq es una herramienta de línea de comandos que trata las bases de datos SQL y los archivos de documentos, como CSV, TSV, JSON y Excel XLSX, como fuentes de datos consultables. Cada fuente se añade con un identificador y se ejecutan comandos sobre ella con un lenguaje de consultas tipo jq o con SQL nativo.

sq permite combinar datos de distintas fuentes, por ejemplo, un archivo CSV con una tabla de Postgres o una tabla de MySQL con una hoja de Excel. Los resultados de las consultas se pueden exportar a formatos como JSON, CSV, XLSX, HTML, Markdown y XML, o insertar directamente en una tabla de una base de datos. También permite inspeccionar la estructura de las fuentes (tablas, columnas y tamaños), comparar esquemas y filas, y copiar, truncar o eliminar tablas.

El proyecto incluye drivers para SQLite, DuckDB, PostgreSQL, SQL Server, MySQL, ClickHouse, Oracle y rqlite, y se puede instalar mediante Homebrew, Scoop, un script de shell, Go o Docker.

Funciones clave

  • 01Consultar fuentes de datos con sintaxis tipo jq o SQL nativo.
  • 02Combinar tablas de distintas fuentes, por ejemplo, CSV con Postgres.
  • 03Exportar resultados a JSON, CSV, XLSX, HTML, Markdown, XML y otros formatos.
  • 04Inspeccionar metadatos de las fuentes y comparar esquemas o filas.
  • 05Copiar, truncar y eliminar tablas de fuentes de bases de datos SQL.

Casos de uso

  • Combinar una hoja de Excel o una exportación CSV con una tabla de una base de datos de producción para realizar análisis puntuales.
  • Inspeccionar desde la terminal una base de datos SQLite o Postgres desconocida.
  • Convertir una hoja de cálculo o un CSV a JSON u otro formato en una canalización de shell.
  • Comparar esquemas o datos entre dos entornos de bases de datos.

Inicio rápido

  1. 1

    Instalar en macOS con Homebrew

    brew install sq
  2. 2

    Instalar en Windows con Scoop (añade primero el bucket)

    scoop bucket add sq https://github.com/neilotoole/sq
  3. 3

    Instalar con Go (se requieren las build tags de SQLite)

    go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest
  4. 4

    Ejecutar el script oficial de instalación para Linux indicado en el README

Antes de usarlo

  • La instalación en Linux depende de un script de shell descargado. Además, la instalación con Go muestra la versión v0.0.0-dev, salvo que se compile desde un clon con make install.

En colecciones

Herramientas de CLI y terminalBases de datos y herramientas SQL

Temas

#sql#cli#data-wrangling#csv#excel#database-tools#golang#azure-sql-edge#data-wrangler#database

Preguntas frecuentes

¿Qué es sq?
Herramienta de línea de comandos para consultar y combinar bases de datos SQL y archivos como CSV, Excel y JSON con sintaxis tipo jq o SQL. sq es una herramienta de línea de comandos que trata las bases de datos SQL y los archivos de documentos, como CSV, TSV, JSON y Excel XLSX, como fuentes de datos consultables. Cada fuente se añade con un identificador y se ejecutan comandos sobre ella con un lenguaje de consultas tipo jq o con SQL nativo.
¿sq es gratuito? ¿Qué licencia tiene?
sq es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿sq sigue mantenido?
Mantenimiento activo. El último commit de sq fue el 21 oct 2026.
¿Para qué puedo usar sq?
Combinar una hoja de Excel o una exportación CSV con una tabla de una base de datos de producción para realizar análisis puntuales. Inspeccionar desde la terminal una base de datos SQLite o Postgres desconocida. Convertir una hoja de cálculo o un CSV a JSON u otro formato en una canalización de shell. Comparar esquemas o datos entre dos entornos de bases de datos.
¿Cómo se instala sq?
Instalar en macOS con Homebrew: brew install sq Instalar en Windows con Scoop (añade primero el bucket): scoop bucket add sq https://github.com/neilotoole/sq Instalar con Go (se requieren las build tags de SQLite): go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest Ejecutar el script oficial de instalación para Linux indicado en el README
¿Dónde consigo sq?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/neilotoole/sq

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados