ClickHouse Client CLI
Нативный клиент ClickHouse выполняет SQL и выгружает результат для аналитических запросов, подготовленных агентом.
- 50 763 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Клиент читает и может менять данные согласно SQL и правам учетной записи; выгрузки сохраняют содержимое таблиц локально.
Установка
Ручная установка
curl https://clickhouse.com/ | shПервый способ README. Команда загружает ClickHouse; скачанный клиент запускается как ./clickhouse client. Изучите скрипт до выполнения.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Клиент читает и может менять данные согласно SQL и правам учетной записи; выгрузки сохраняют содержимое таблиц локально.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Перед запросом пользователь выбирает сервер и учетную запись базы. ClickHouse Client читает эти параметры из командной строки или конфигурации. SQL можно ввести вручную либо передать из сценария: агент готовит запрос, а пользователь получает таблицу или машинно-читаемый результат. Во время запроса видны прогресс, объем прочитанных данных и время выполнения. CSV и JSON подходят для передачи результата следующим командам. Права пользователя базы действуют и при запуске из сценария: клиент выполняет только разрешенные этой учетной записи операции.
Для кого. Специалистам по аналитике ClickHouse, которые составляют запросы с агентом и проверяют результат через обычный терминальный клиент.
Подходит, если
- Агент подготовил аналитический SQL, и нужно выполнить его на согласованной базе.
- Результат запроса требуется выгрузить в CSV или JSON для дальнейшей обработки.
- При долгом запросе пользователь хочет видеть прогресс чтения данных.
- В сценарии нужно повторять запросы с явно заданным подключением.
Не подходит, если
- Ищете средство управления другой СУБД или произвольным HTTP API.
- У агента нет разрешения читать выбранные таблицы.
- Изменяющий SQL собираются запускать без проверки его текста и подключения.
Пример запроса к агенту
Подготовь читающий запрос к согласованной таблице, объясни фильтр и формат результата; запуск выполним после проверки подключения.Ограничения
Для запросов нужен доступный сервер ClickHouse; клиент подключается по нативному протоколу, поэтому адрес HTTP-интерфейса не подходит автоматически. Старый клиент может не поддерживать функции нового сервера, и документация рекомендует совпадающие версии. Разрешения определяются пользователем базы: установка CLI не делает запросы безопасными или только читающими. Конфигурация соединения может содержать пароль, поэтому храните ее вне общего репозитория и проверяйте, какое подключение выбрано.
Как отключить. Завершите клиентскую сессию и остановите вызывающие ее задания. Закрытие клиента не отменяет уже выполненные изменения данных.
Частые вопросы
Как запустить скачанный бинарник без системной установки?
Используйте `./clickhouse client`.
Можно выгрузить результат в CSV?
Да. Задайте `--format CSV` при запуске клиента или добавьте `FORMAT CSV` к SQL-запросу. Клиент выведет результат в выбранном формате.
Клиент работает через HTTP?
Нет. Этот клиент использует нативный протокол ClickHouse.
Что видно во время долгого запроса?
Прогресс, число прочитанных строк, объем данных и время выполнения.
Где хранить несколько подключений?
В файле конфигурации, выбранном через `--config`, опишите блок `connections_credentials` с именами соединений. Затем выбирайте соединение параметром `--connection`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОфициальный MCP-сервер ClickHouse: агент смотрит базы и таблицы и выполняет SQL, по умолчанию только на чтение
Официальные скиллы ClickHouse: правила схем и запросов, архитектурные решения, chDB для Python и работа с ClickHouse Cloud
MCP-сервер на Go для запросов к ClickHouse: схемы, SQL, инструменты из представлений, OAuth и развертывание в Kubernetes
chmonitor — панель мониторинга ClickHouse со встроенным MCP-сервером: агент читает состояние кластера запросами только на чтение
SQL-клиент объединяет просмотр баз и пакетные запросы, чтобы агент работал с выбранным подключением и результатами в JSON.
Десктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
Коротко о README
Основной репозиторий содержит СУБД и ее нативный клиент. Установочная команда README предназначена для Linux, macOS и FreeBSD.