ClickHouse

Операционная система: Ubuntu 22.04.3 LTS

Версия ClickHouse: 23.8.1

Дата обновления статьи: 1 сентября 2023

Установка

1. Войти в режим sudo и обновить систему:

   $ sudo -i
   $ apt update
   $ apt upgrade
   

2. Добавить репозиторий

   $ apt-get install -y apt-transport-https ca-certificates dirmngr

   $ apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

   $ echo 'deb https://packages.clickhouse.com/deb stable main' > /etc/apt/sources.list.d/clickhouse.list
   $ apt update
   

3. Установка сервера ClickHouse

   $ apt-get install -y clickhouse-server
   # При установке необходимо ввести пароль для пользователя по умолчанию
   

4. Запустить службу ClickHouse-server, так, чтобы при перезагрузке она стартовала автоматически

   $ systemctl enable --now clickhouse-server
   

   Проверить, что сервер СlickHouse установлен и запущен можно командой

   $ systemctl status clickhouse-server
   

   Создание базы данных и пользователей

5. Установка клиента ClickHouse

   $ apt-get install -y clickhouse-client
   

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

   $ clickhouse-client --ask-password
   # Ввести пароль, который ввели при установке сервера ClickHouse
   

   Для работы Оркестратора 1С необходимо создать базу данных «logs» и двух пользователей:

   1. user_1c c правами на чтение и запись в базе данных logs и в базе данных tj_1c. Используется для добавления и чтения данных записей журналов регистрации 1С.

   2. user_read с правами только на чтение. Используется для получения данных в Grafana.

   :) CREATE USER user_read IDENTIFIED WITH sha256_password BY 'SECRET_PASSWORD1';
   # Заменить SECRET_PASSWORD1 на новый пароль для пользователя
   :) GRANT SELECT ON *.* TO user_read;
   :) CREATE DATABASE logs;
   :) CREATE DATABASE tj_1c;
   :) CREATE USER user_1c IDENTIFIED WITH sha256_password BY 'SECRET_PASSWORD2';
   # Заменить SECRET_PASSWORD2 на новый пароль для пользователя 
   :) GRANT ALL ON logs.* TO user_1c;
   :) GRANT ALL ON tj_1c.* TO user_1c;
   :) GRANT Select ON system.parts TO user_1c;
   

   Выйти из клиента ClickHouse:

   :) exit
   

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

Для добавления записей из Оркестратора 1С необходимо разрешить взаимодействие по протоколу http(s). Для этого нужно открыть файл настроек на редактирование:

$ nano /etc/clickhouse-server/config.xml

Ограничение по хостам, с которых может прийти запрос. Если необходимо, чтобы сервер отвечал всем, то надо указать ::.

Примеры:

<listen_host>::</listen_host>
<listen_host>127.0.0.1</listen_host>

перезапустить сервер:

$ systemctl restart clickhouse-server

Для проверки работы и доступности сервера clickhouse необходимо перейти по ссылке http://hostname:8123. hostname заменить на имя сервера или ip адрес, на котором установлен ClickHouse.

Установка и базовая настройка ClickHouse завершена!

Дополнительно

Официальный сайт: https://clickhouse.com

Документация по ClickHouse: https://clickhouse.com/docs/ru/getting-started/install