trdsql CLI
CLI выполняет SQL над CSV, JSON и другими табличными файлами, чтобы агент объединял выгрузки и менял формат результата.
- 2 176 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI читает выгрузки, может сохранять результат и работать с внешней базой с переданными полномочиями.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/trdsqlОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает выгрузки, может сохранять результат и работать с внешней базой с переданными полномочиями.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
trdsql позволяет обращаться к файлам данных как к таблицам в SQL-запросе. Агент может отфильтровать строки, собрать агрегаты и объединить несколько входных файлов без отдельного этапа ручного импорта. По умолчанию для запросов используется SQLite. При выборе другого драйвера доступны PostgreSQL и MySQL с их синтаксисом. Результат можно вывести как CSV, JSON, Markdown или другой поддерживаемый формат. Настройки входа помогают определить заголовки, разделители и представление пустых значений.
Для кого. Специалистам по табличным выгрузкам, которые предпочитают SQL для соединения и преобразования файлов.
Подходит, если
- Два CSV нужно соединить по общему полю и показать выбранные столбцы.
- Агент готовит сводку JSON-выгрузки через SQL-агрегацию.
- Таблицу требуется перевести в Markdown для отчета.
- Для запроса нужны функции выбранного PostgreSQL или MySQL-драйвера.
Не подходит, если
- Формат или структура файла не укладываются в поддерживаемые табличные входы.
- Нельзя подключить выбранную внешнюю базу с подходящими правами.
- Вы ожидаете одинаковый SQL-синтаксис у всех драйверов.
Пример запроса к агенту
Соедини две тестовые CSV через trdsql, явно задай пустые значения и сохрани результат в новый JSON-файл.Ограничения
Первый сценарий сборки использует старую раскладку GOPATH при требовании Go 1.25 или новее; выберите документированный бинарный релиз своей платформы. Значения NULL в CSV и других текстовых форматах нужно задать явно, иначе пустая строка может получить другой смысл. SQL зависит от выбранного движка: функции PostgreSQL не переносите автоматически на SQLite. При подключении внешней базы и записи результата инструмент использует ее права и указанные пути, поэтому выбирайте тестовое соединение и отдельный выходной файл.
Как отключить. Завершите запрос и удалите ненужное подключение к внешней базе. Сохраненные результаты остаются файлами, исходные выгрузки храните отдельно.
Частые вопросы
Нужна ли внешняя база?
Нет. По умолчанию выбран драйвер SQLite; внешние движки подключаются отдельно.
Как выбрать JSON-вывод?
Используйте `-ojson`.
Можно ли прочитать запрос из файла?
Да. Для этого есть параметр `-q`.
Как считать пустые поля NULL?
Настройте `-inull` под представление пустого значения в вашей выгрузке.
Можно ли получить SQL-подсказку по файлу?
Да. Параметры анализа файла помогают посмотреть структуру и предложенный запрос.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI импортирует CSV и JSON в SQLite, выполняет SQL и меняет схему, чтобы агент готовил локальные наборы данных для анализа.
SQL-клиент объединяет просмотр баз и пакетные запросы, чтобы агент работал с выбранным подключением и результатами в JSON.
Десктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
VisiData открывает таблицы разных форматов в терминале и помогает исследовать и упорядочивать данные через клавиатуру.
Harlequin дает SQL-редактор в терминале, а входящий в поставку hsql выполняет запросы и читает структуру базы для агентов.
dblab, терминальный SQL-клиент, сохраняет профили подключений и может хранить пароли в системном хранилище ключей.
Коротко о README
Программа поддерживает сжатые входы и несколько форматов вывода. Можно соединять файл с таблицей подключенной базы.