Установка и использование ClickHouse на Linux

Используемые термины: ClickHouse , Linux .

В данной инструкции мы разберемся с базовыми действиями по администрированию ClickHouse — установкой, настройкой и выполнением некоторых запросов. Мы будем работать на системах Linux — Ubuntu и Rocky Linux.

Установка и запуск ClickHouse

В родных репозиториях deb и rpm нет ClickHouse. Для начала мы выполним их конфигурирование и уже после — установку базы данных. В зависимости от типа дистрибутива Linux, наши действия будут отличаться.

Установка на RPM

Для добавления репозитория мы будем использовать yum-utils:

Теперь устанавливаем кликхаус командой:

Для установки конкретной версии, если она есть в репозитории, вводим название пакета с указанием самой версии, например:

yum install clickhouse-server-23.1.3.5 clickhouse-client-23.1.3.5

Запускаем сервис и разрешаем его автозапуск:

Установка на Deb

Устанавливаем пакеты:

Установим gpg-ключ репозитория с сервера ключей:

Добавим репозиторий:

Обновим кэш:

Можно устанавливать clickhouse:

Запускаем сервис и разрешаем его автозапуск:

Управление доступом

После установки clickhouse мы можем подключиться к серверу без ввода логина и пароля под пользователем default. Для этого достаточно в консоли ввести команду:

Для контроля доступа к базе в официальной документации рекомендуется использовать SQL-ориентированное управление. Нам необходимо выполнить следующие шаги:

1. Включить SQL-ориентированный контроль доступа.
2. Создать суперпользователя.
3. Удалить доступ для пользователя default.

Рассмотрим эти шаги подробнее.

1) Открываем файл:

В разделе users для пользователя default задаем опции access_management , named_collection_control , show_named_collections и show_named_collections_secrets :

* желтым показаны опции, которым необходимо задать значение 1 .

Для применения настроек перезапускаем сервис:

2) Для создания пользователя подключаемся к серверу:

Создаем учетную запись для суперпользователя:

* в данном примере мы создали пользователя root , которому можно подключаться только с локального хоста ( HOST LOCAL ) и паролем password .

Даем ему полные права на все базы и таблицы:

Если мы получим ошибку с сообщением, что у пользователя default не хватает прав, выполняем команду:

GRANT ALL ON *.* TO default WITH GRANT OPTION;

Выходим из командной оболочки:

Проверяем доступ, попробовав подключиться к серверу баз данных:

Система запросит пароль. Вводим тот, что задали при создании пользователя (в нашем случае это password ).

В итоге, мы должны увидеть приглашение на ввод SQL-команд:

Теперь можно создать пользователей для подключения к базе. Команда подобна той, что мы использовали для создания пользователя root:

* подробнее процесс описан на официальном сайте .

Задать права можно командой:

Список пользователей можно посмотреть командой:

3) В официальной документации рекомендуют ограничить доступ пользователю default, оставив права только на чтение.

Для этого открываем файл:

В разделе users для default приводим опции к виду:

* в данном примере для пользователя default мы задаем профиль readonly и возвращаем значение для access_management в 0 .

Перезапускаем сервис для сохранения настроек:

Подключение по сети

По умолчанию, кликхаус слушает запросы на локальной петле и не принимает запросов по сети. Для решения задачи нам нужно сделать следующее:

1. Разрешить сервису обработку сетевых запросов.
2. Создать учетную запись для подключения с удаленного хоста.

Рассмотрим пример настройки сервера и подключения к нему с клиента.

Настройка сервера

Открываем файл:

Приводим опцию к виду:

* в данном примере мы говорим серверу слушать на всех сетевых адресах IPv4. Обратите внимание, что данная опция есть в конфигурационном файле, но она закомментирована.

Для применения настроек вводим:

Проверить, что сервер стал слушать на всех интерфейсах IPv4 можно с помощью команды:

Теперь заходим в оболочку SQL, например, с помощью ранее созданной учетной записью root:

И создаем учетную запись для подключения по сети:

* в нашем примере мы создадим учетную запись remote с паролем password для подключения к нашему серверу из локальной сети 192.168.100.0/24 . Мы также можем указать не подсеть, а конкретный узел, с которого пользователю будет разрешено подключение.

Если на сервере используется брандмауэр, то необходимо открыть порт 9000. В зависимости от утилиты управления, наши команды будут отличаться.

а) для Iptables:

Для сохранения правил используем iptables-persistent:

б) для firewalld:

И применяем настройку:

Теперь можно попробовать подключиться с другого узла.

Установка клиента

На сервер необходимо установить клиента. В зависимости от типа дистрибутива Linux, наши действия будут отличаться.

а) на RPM.

Теперь устанавливаем клиента командой:

б) на Deb.

Устанавливаем пакеты:

Установим gpg-ключ репозитория с сервера ключей:

Добавим репозиторий:

Обновим кэш:

Можно устанавливать клиента:

Подключение к серверу

Теперь можно подключиться клиентом к серверу:

После ввода команды система попросить ввести пароль:

В итоге, мы должны увидеть приглашение к вводу команд SQL: