Repolode
Enviar
neilotoole

neilotoole/sq

Ferramenta de linha de comando para consultar e combinar bancos de dados SQL e arquivos como CSV, Excel e JSON com sintaxe no estilo jq ou SQL.

Ver no GitHubSite
Estrelas
2,573
Forks
43
Issues abertas
87
Último commit
ontem

O que é?

sq é uma ferramenta de linha de comando que trata bancos de dados SQL e arquivos de documentos, como CSV, TSV, JSON e Excel XLSX, como fontes de dados consultáveis. Cada fonte é adicionada com um identificador, e os comandos são executados nela usando uma linguagem de consulta no estilo jq ou SQL nativo.

O sq permite combinar dados de diferentes fontes, por exemplo, um arquivo CSV com uma tabela do Postgres ou uma tabela do MySQL com uma planilha do Excel. Os resultados das consultas podem ser gravados em formatos como JSON, CSV, XLSX, HTML, Markdown e XML, ou inseridos diretamente em uma tabela de banco de dados. A ferramenta também inspeciona a estrutura das fontes (tabelas, colunas e tamanhos), compara esquemas e dados de linhas, e copia, trunca ou remove tabelas.

O projeto lista drivers para SQLite, DuckDB, PostgreSQL, SQL Server, MySQL, ClickHouse, Oracle e rqlite, e pode ser instalado via Homebrew, Scoop, script de shell, Go ou Docker.

Recursos principais

  • 01Consultar fontes de dados com sintaxe no estilo jq ou SQL nativo.
  • 02Combinar tabelas de diferentes fontes, como CSV e Postgres.
  • 03Exportar resultados para JSON, CSV, XLSX, HTML, Markdown, XML e outros formatos.
  • 04Inspecionar metadados das fontes e comparar esquemas ou dados de linhas.
  • 05Copiar, truncar e remover tabelas em fontes de bancos de dados SQL.

Casos de uso

  • Combinar uma planilha do Excel ou um arquivo CSV exportado com uma tabela de banco de dados de produção para uma análise pontual.
  • Inspecionar pelo terminal um banco de dados SQLite ou Postgres desconhecido.
  • Converter uma planilha ou um arquivo CSV para JSON ou outro formato em um pipeline de shell.
  • Comparar esquemas ou dados entre dois ambientes de banco de dados.

Início rápido

  1. 1

    Instalar no macOS com Homebrew

    brew install sq
  2. 2

    Instalar no Windows com Scoop (adicione o bucket primeiro)

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

    Instalar com Go (as build tags do SQLite são necessárias)

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

    Executar o script oficial de instalação para Linux indicado no README

Antes de usar

  • A instalação no Linux depende de um script de shell baixado. Além disso, a instalação com Go informa a versão v0.0.0-dev, a menos que seja compilada a partir de um clone com make install.

Em coleções

Ferramentas de CLI e terminalBancos de dados e ferramentas SQL

Tópicos

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

Perguntas frequentes

O que é sq?
Ferramenta de linha de comando para consultar e combinar bancos de dados SQL e arquivos como CSV, Excel e JSON com sintaxe no estilo jq ou SQL. sq é uma ferramenta de linha de comando que trata bancos de dados SQL e arquivos de documentos, como CSV, TSV, JSON e Excel XLSX, como fontes de dados consultáveis. Cada fonte é adicionada com um identificador, e os comandos são executados nela usando uma linguagem de consulta no estilo jq ou SQL nativo.
sq é gratuito? Qual é a licença?
sq é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
sq ainda é mantido?
Manutenção ativa. O último commit de sq foi em 21 de out. de 2026.
Para que posso usar sq?
Combinar uma planilha do Excel ou um arquivo CSV exportado com uma tabela de banco de dados de produção para uma análise pontual. Inspecionar pelo terminal um banco de dados SQLite ou Postgres desconhecido. Converter uma planilha ou um arquivo CSV para JSON ou outro formato em um pipeline de shell. Comparar esquemas ou dados entre dois ambientes de banco de dados.
Como instalar sq?
Instalar no macOS com Homebrew: brew install sq Instalar no Windows com Scoop (adicione o bucket primeiro): scoop bucket add sq https://github.com/neilotoole/sq Instalar com Go (as build tags do SQLite são necessárias): go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest Executar o script oficial de instalação para Linux indicado no README
Onde consigo sq?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/neilotoole/sq

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados