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

На странице Хранилища данных находится список системных и пользовательских серверов 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 в пространстве смотрите на странице Подключения.