Пользователи WindowsClickHouse работает нативно в Linux и macOS. В Windows выполняйте эти шаги в
Windows Subsystem for Linux (WSL).
clickhousectl, псевдоним chctl) устанавливает локальные версии
ClickHouse и управляет ими, запускает локальные серверы ClickHouse и Postgres, выполняет запросы,
а также управляет ClickHouse Cloud. На этой странице описано, как установить CLI,
запустить локальный сервер ClickHouse и подключиться к нему.
Если вы использовали скрипт быстрой установки,
clickhousectl уже установлен. Перейдите к разделу
Установка ClickHouse.
1
Установите ClickHouse CLI
Скрипт установки поддерживает macOS и Linux на архитектурах x86_64 и ARM64:Скрипт устанавливает
Чтобы проверить наличие нового релиза CLI и установить его:
clickhousectl в ~/.local/bin и создаёт рядом с ним псевдоним chctl.
Если скрипт сообщает, что каталога ~/.local/bin нет в переменной PATH, добавьте его туда,
а чтобы это работало и в последующих сеансах, добавьте ту же строку в профиль командной оболочки
(~/.bashrc, ~/.zshrc):Другие способы установки
Другие способы установки
Псевдоним
chctl создают только скрипт установки и npm.2
Установите ClickHouse
Установите последнюю версию ClickHouse и сделайте её версией по умолчанию:Чтобы узнать, какие минорные версии доступны для загрузки и какие версии у вас
уже установлены:
local use устанавливает версию, если она ещё не установлена, делает её версией
по умолчанию и создаёт символическую ссылку clickhouse в ~/.local/bin, чтобы
исполняемый файл clickhouse можно было запускать напрямую. Благодаря этому все последующие шаги в этой документации, где выполняется
команда clickhouse, будут работать без изменений — при условии, что каталог ~/.local/bin указан в переменной PATH.Также можно выбрать последний релиз с долгосрочной поддержкой (LTS) или конкретную
версию:use и install
clickhousectl 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
Подключитесь к серверу с помощью Команда Теперь можно отправлять SQL-команды в ClickHouse! Чтобы выйти из клиента, введите
clickhouse-client из того же каталога:local client подключается к серверу с именем default и использует ту же
версию ClickHouse, что и сервер. Чтобы подключиться к другому серверу, укажите его имя,
например clickhousectl local client dev. Вывод будет примерно таким:exit.Чтобы выполнить один запрос, не открывая интерактивный сеанс, используйте параметр -q:5
Остановите сервер
Сервер работает в фоновом режиме, пока вы его не остановите. Чтобы остановить его, выполните команду из того же
каталога:При остановке данные сервера сохраняются до следующего запуска
clickhousectl local server start.Дальнейшие шаги
-
Запустите Postgres локально. Убедитесь, что Docker запущен, затем запустите локальный сервер Postgres
и подключитесь к нему с помощью
psql: -
Подключитесь к ClickHouse Cloud. Создайте аккаунт или войдите в существующий.
Вход через браузер дает доступ только для чтения; для создания или изменения ресурсов Cloud
нужен ключ API — его запросит команда
clickhousectl cloud auth login --interactive. -
Изучите остальные возможности CLI. См. справочник по clickhousectl
или выполните
clickhousectl --help.