Хранилища данных

На странице Хранилища данных находится список серверов ClickHouse.

Чтобы добавить новое подключение, нажмите Добавить в левом верхнем углу и введите:

• название
• кластерный режим (Вкл/Выкл)
• хост
• порт
• имя пользователя
• пароль
• SSL (Вкл/Выкл)

При клике Добавить происходит проверка соединения. При успешной проверке соединение будет создано, и осуществится переход в профиль соединения. Если проверка не прошла, появится сообщение об ошибке.

Доступ к списку серверов, возможности добавления и редактирования новых подключений регламентируются привилегией «Хранилища».

Профиль сервера ClickHouse

Чтобы зайти в профиль сервера ClickHouse, нажмите значок контекстного меню и выберите пункт Редактировать.

Вкладка Основное

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

• название соединения
• хост
• порт
• имя пользователя
• пароль
• SSL
• память на один запрос (МБ)
• количество одновременных подключений
• размер очереди на выполнение
• время сессии (минуты)

На вкладке также возможно «Проверить соединение».

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

После сохранения автоматически проводится проверка подключения.

Вкладка Доступы

Во вкладке Доступы назначается доступ пользователям на создание пространств на выбранном сервере.

Чтобы дать пользователям доступ к серверу, нажмите + Добавить и выберите сотрудников из списка. Чтобы запретить сотруднику доступ к серверу, нажмите иконку корзины.

Кластерный режим

Кластерный режим позволяет указать несколько серверов ClickHouse в одном подключении. Это помогает распределить нагрузку с одного сервера на несколько.

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

• название подключения
• имя кластера

Во вкладке Основное отображается:

• название сервера
• имя кластера
• время сессии (указывается в минутах)

Во вкладке Соединения отображается список подключенных серверов. Каждое соединение настраивается отдельно через кнопку Добавить.

Соединения удаляются без ограничений.

Рекомендации по работе с ClickHouse в кластерном режиме

Чтобы данные дублировались по всем нодам ClickHouse, используйте в кластерном режиме 1 шард и много реплик.

Также необходимо использовать движки семейства Replicated.

В кластерном режиме много соединений в рамках одного подключения, и при запросе на дашборд запросы будут распределяться по этим соединениям. Поэтому при создании, удалении, переименовании таблицы через SQL-запрос необходимо прописывать в тексте запроса «ON CLUSTER cluster_name».

Пример:

CREATE TABLE table_name ON CLUSTER cluster_name 
DROP TABLE table_name ON CLUSTER cluster_name 
RENAME TO table_name ON CLUSTER cluster_name
TRUNCATE TABLE table_name ON CLUSTER cluster_name

Если не прописать данный параметр, то запрос выполнится в отдельно взятой ноде, на других нодах изменения не применятся.

При пересоздании ранее удаленной таблицы на движке ReplicatedReplacingMergeTree может возникнуть ошибка. Ее можно обойти с помощью передачи дополнительных параметров для zookeeper: zoo_path — путь до таблицы в ClickHouse Keeper.

Пример:

ENGINE = ReplicatedMergeTree('/clickhouse/tables/{shard}/{database}/table_name_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx', '{replica}')

Подключение к ClickHouse в пространстве

О подключении ClickHouse в пространстве смотрите на странице Подключения.