Repolode
neilotoole

neilotoole/sq

CLI-инструмент для запросов к SQL-базам и файлам вроде CSV, Excel и JSON с помощью синтаксиса в стиле jq или SQL.

Звёзды
2,573
Форки
43
Открытые issues
87
Последний коммит
вчера

Что это?

sq — CLI-инструмент, который позволяет работать с SQL-базами и документами, такими как CSV, TSV, JSON и Excel XLSX, как с источниками данных для запросов. Каждому источнику назначается псевдоним, после чего команды выполняются с использованием либо языка запросов в стиле jq, либо обычного SQL.

sq позволяет объединять данные из разных источников, например CSV-файл с таблицей Postgres или таблицу MySQL с листом Excel. Результаты запросов можно сохранять в форматах JSON, CSV, XLSX, HTML, Markdown и XML или напрямую записывать в таблицу базы данных. Инструмент также изучает структуру источников (таблицы, столбцы, размеры), сравнивает схемы и данные строк, а также копирует, очищает и удаляет таблицы.

В проекте перечислены драйверы для SQLite, DuckDB, PostgreSQL, SQL Server, MySQL, ClickHouse, Oracle и rqlite. Установить sq можно через Homebrew, Scoop, shell-скрипт, Go или Docker.

Ключевые возможности

  • 01Выполняйте запросы к источникам данных с помощью синтаксиса в стиле jq или обычного SQL.
  • 02Объединяйте таблицы из разных источников, например CSV и Postgres.
  • 03Экспортируйте результаты в JSON, CSV, XLSX, HTML, Markdown, XML и другие форматы.
  • 04Просматривайте метаданные источников и сравнивайте схемы или данные строк.
  • 05Копируйте, очищайте и удаляйте таблицы в SQL-базах данных.

Сценарии использования

  • Объединение листа Excel или выгрузки CSV с таблицей рабочей базы данных для разового анализа.
  • Просмотр незнакомой базы SQLite или Postgres из терминала.
  • Преобразование таблицы или CSV в JSON либо другой формат в shell-конвейере.
  • Сравнение схем или данных между двумя средами баз данных.

Быстрый старт

  1. 1

    Установить на macOS с помощью Homebrew

    brew install sq
  2. 2

    Установить на Windows с помощью Scoop (сначала добавьте bucket)

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

    Установить с помощью Go (требуются build tags для SQLite)

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

    Запустить официальный скрипт установки для Linux из README

Что важно знать

  • Установка в Linux использует загруженный shell-скрипт. Кроме того, при установке через Go отображается версия v0.0.0-dev, если сборка не выполнена из клона репозитория командой make install.

В подборках

Темы

Частые вопросы

Что такое sq?
CLI-инструмент для запросов к SQL-базам и файлам вроде CSV, Excel и JSON с помощью синтаксиса в стиле jq или SQL. sq — CLI-инструмент, который позволяет работать с SQL-базами и документами, такими как CSV, TSV, JSON и Excel XLSX, как с источниками данных для запросов. Каждому источнику назначается псевдоним, после чего команды выполняются с использованием либо языка запросов в стиле jq, либо обычного SQL.
sq можно использовать бесплатно? Какая у него лицензия?
sq распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
sq всё ещё поддерживается?
Активно поддерживается. Последний коммит в sq — 21 окт. 2026 г..
Для чего можно использовать sq?
Объединение листа Excel или выгрузки CSV с таблицей рабочей базы данных для разового анализа. Просмотр незнакомой базы SQLite или Postgres из терминала. Преобразование таблицы или CSV в JSON либо другой формат в shell-конвейере. Сравнение схем или данных между двумя средами баз данных.
Как установить sq?
Установить на macOS с помощью Homebrew: brew install sq Установить на Windows с помощью Scoop (сначала добавьте bucket): scoop bucket add sq https://github.com/neilotoole/sq Установить с помощью Go (требуются build tags для SQLite): go install -tags "sqlite_vtable sqlite_stat4 sqlite_fts5 sqlite_introspect sqlite_json sqlite_math_functions" github.com/neilotoole/sq@latest Запустить официальный скрипт установки для Linux из README
Где скачать sq?
Исходный код и инструкции по установке — на GitHub: https://github.com/neilotoole/sq

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты