Создание подключения к ClickHouse
Примечание
- Подключение к ClickHouse выполняется только по HTTP-интерфейсу.
- Все запросы к данным выполняются с включенным флагом join_use_nulls. Ознакомьтесь с разделом Особенности работы с подключением к ClickHouse, если вы используете представления (VIEW) или подзапросы с секцией JOIN в DataLens.
Важно
При подключении к внешнему источнику данных (который не является ресурсом Yandex.Cloud), необходимо предоставить доступ к источнику для следующих диапазонов IP-адресов сервиса DataLens:
178.154.242.176/28
178.154.242.192/28
178.154.242.208/28
178.154.242.128/28
178.154.242.144/28
178.154.242.160/28
Подключение к ClickHouse
Чтобы создать подключение к ClickHouse:
-
Перейдите на страницу подключений.
-
Нажмите кнопку Создать подключение.
-
Выберите коннектор ClickHouse.
-
Задайте Имя подключения. Имя может быть произвольным.
-
Выберите тип подключения:
Выбрать в ОблакеУказать вручнуюУкажите параметры подключения для БД ClickHouse, доступной в Yandex.Cloud:
-
Кластер. Укажите кластер из списка доступных кластеров ClickHouse. Если у вас нет доступного кластера, нажмите кнопку Создать новый.
Примечание
В списке кластеров отображаются кластеры ClickHouse:
- с правами доступа для пользователя создающего подключение;
- созданные в том же каталоге, что и экземпляр DataLens.
-
Имя хоста. Выберите имя хоста из списка доступных в кластере ClickHouse.
-
Порт HTTP-интерфейса. Укажите порт подключения к ClickHouse. Порт по умолчанию — 8443.
-
Имя пользователя. Укажите имя пользователя для подключения к ClickHouse.
Важно
У пользователя должно быть установлено одно из следующих значений параметра readonly:
0
— разрешены все запросы;2
— разрешены запросы на чтение данных и изменение настроек.
-
Пароль. Укажите пароль для пользователя.
-
HTTPS. Проверьте, что опция безопасного подключения активирована.
Укажите параметры подключения для внешней БД ClickHouse:
-
Имя хоста. Укажите путь до хоста или IP-адрес хоста ClickHouse.
-
Порт HTTP-интерфейса. Укажите порт подключения к ClickHouse. Порт по умолчанию — 8443.
-
Имя пользователя. Укажите имя пользователя для подключения к ClickHouse.
Важно
У пользователя должно быть установлено одно из следующих значений параметра readonly:
0
— разрешены все запросы;2
— разрешены запросы на чтение данных и изменение настроек.
-
Пароль. Укажите пароль для пользователя.
-
HTTPS. Активируйте опцию безопасного подключения, если ваш сервер поддерживает протокол HTTPS.
-
-
Нажмите Сохранить. Подключение появится в списке.
Примечание
Вы можете проверить подключение к хосту перед созданием. Для этого нажмите кнопку Проверить подключение.
Особенности работы с подключением к ClickHouse
Вы можете создавать датасеты поверх представлений (VIEW) в ClickHouse, содержащих секцию JOIN. Для этого представление должно быть создано с включенной опцией join_use_nulls
. Рекомендуется выставлять настройку join_use_nulls = 1
в секции SETTINGS
:
CREATE VIEW ... (
...
) AS
SELECT
...
FROM
...
SETTINGS join_use_nulls = 1
Также следует включать эту опцию для подзапросов raw-sql, которые иcпользуются как источник данных в датасете.
Чтобы избежать ошибок при работе с представлениями в DataLens, содержащими секцию JOIN, создайте заново все представления с настройкой join_use_nulls = 1
. Пустые ячейки при этом заполнятся значениями NULL
, а тип соответствующих полей преобразуется в Nullable.