Перейти к основному содержанию
Пользователи WindowsClickHouse работает нативно в Linux и macOS. В Windows выполняйте эти шаги в Windows Subsystem for Linux (WSL).
ClickHouse CLI (clickhousectl, псевдоним chctl) устанавливает локальные версии ClickHouse и управляет ими, запускает локальные серверы ClickHouse и Postgres, выполняет запросы, а также управляет ClickHouse Cloud. На этой странице описано, как установить CLI, запустить локальный сервер ClickHouse и подключиться к нему. Если вы использовали скрипт быстрой установки, clickhousectl уже установлен. Перейдите к разделу Установка ClickHouse.
1

Установите ClickHouse CLI

Скрипт установки поддерживает macOS и Linux на архитектурах x86_64 и ARM64:
Скрипт устанавливает clickhousectl в ~/.local/bin и создаёт рядом с ним псевдоним chctl. Если скрипт сообщает, что каталога ~/.local/bin нет в переменной PATH, добавьте его туда, а чтобы это работало и в последующих сеансах, добавьте ту же строку в профиль командной оболочки (~/.bashrc, ~/.zshrc):
Псевдоним chctl создают только скрипт установки и npm.
Чтобы проверить наличие нового релиза CLI и установить его:
2

Установите ClickHouse

Установите последнюю версию ClickHouse и сделайте её версией по умолчанию:
local use устанавливает версию, если она ещё не установлена, делает её версией по умолчанию и создаёт символическую ссылку clickhouse в ~/.local/bin, чтобы исполняемый файл clickhouse можно было запускать напрямую. Благодаря этому все последующие шаги в этой документации, где выполняется команда clickhouse, будут работать без изменений — при условии, что каталог ~/.local/bin указан в переменной PATH.Также можно выбрать последний релиз с долгосрочной поддержкой (LTS) или конкретную версию:
Чтобы узнать, какие минорные версии доступны для загрузки и какие версии у вас уже установлены:
use и installclickhousectl local use <version> устанавливает версию и делает её версией по умолчанию, обновляя символическую ссылку clickhouse. clickhousectl local install <version> только загружает версию: она становится версией по умолчанию, лишь если такая версия ещё не задана, а символическая ссылка при этом не обновляется. Чтобы задать версию по умолчанию, не создавая и не обновляя символическую ссылку, используйте clickhousectl local use <version> --no-global.
3

Запустите clickhouse-server

clickhousectl привязывает локальные серверы к каталогу, из которого он запущен. Создайте каталог проекта и запустите в нём сервер:
Сервер работает в фоновом режиме и называется default. Его данные хранятся в ./.clickhouse/, поэтому последующие команды clickhousectl local запускайте из того же каталога: clickhousectl не ищет данные в родительских каталогах. Сервер прослушивает HTTP-порт 8123 и TCP-порт 9000, а если они заняты — свободные порты. Чтобы задать порты, используйте параметры --http-port и --tcp-port. Чтобы запустить несколько серверов, присвойте каждому имя, например: clickhousectl local server start dev.Чтобы убедиться, что сервер работает, выполните:
4

Запустите клиент ClickHouse

Подключитесь к серверу с помощью clickhouse-client из того же каталога:
Команда local client подключается к серверу с именем default и использует ту же версию ClickHouse, что и сервер. Чтобы подключиться к другому серверу, укажите его имя, например clickhousectl local client dev. Вывод будет примерно таким:
Теперь можно отправлять SQL-команды в ClickHouse! Чтобы выйти из клиента, введите exit.Чтобы выполнить один запрос, не открывая интерактивный сеанс, используйте параметр -q:
В руководстве Создание таблиц в ClickHouse пошагово описано, как создавать таблицы и вставлять в них данные.
5

Остановите сервер

Сервер работает в фоновом режиме, пока вы его не остановите. Чтобы остановить его, выполните команду из того же каталога:
При остановке данные сервера сохраняются до следующего запуска clickhousectl local server start.
Команда clickhousectl local server remove безвозвратно удаляет данные остановленного сервера.

Дальнейшие шаги

  • Запустите Postgres локально. Убедитесь, что Docker запущен, затем запустите локальный сервер Postgres и подключитесь к нему с помощью psql:
  • Подключитесь к ClickHouse Cloud. Создайте аккаунт или войдите в существующий. Вход через браузер дает доступ только для чтения; для создания или изменения ресурсов Cloud нужен ключ API — его запросит команда clickhousectl cloud auth login --interactive.
  • Изучите остальные возможности CLI. См. справочник по clickhousectl или выполните clickhousectl --help.