Создание подключения к ClickHouse

Примечание

Все запросы к данным выполняются с включенным флагом join_use_nulls. Ознакомьтесь с разделом Особенности работы с подключением к ClickHouse, если вы используете представления (VIEW) или подзапросы с секцией JOIN в DataLens.

Чтобы создать подключение к ClickHouse:

  1. Перейдите на страницу воркбука.

  2. В правом верхнем углу нажмите СоздатьПодключение.

  3. Выберите подключение ClickHouse.

  4. Укажите параметры подключения для внешней БД ClickHouse:

    • Имя хоста. Укажите путь до хоста-мастера или IP-адрес хоста-мастера ClickHouse. Вы можете указать несколько хостов через запятую. Если к первому хосту подключиться не получится, DataLens выберет следующий из списка.

    • Порт HTTP-интерфейса. Укажите порт подключения к ClickHouse. Порт по умолчанию — 8443.

    • Имя пользователя. Укажите имя пользователя для подключения к ClickHouse.

      Важно

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

      • 0 — разрешены все запросы;
      • 2 — разрешены запросы на чтение данных и изменение настроек.
    • Пароль. Укажите пароль для пользователя.

    • Время жизни кеша в секундах. Укажите время жизни кеша или оставьте значение по умолчанию. Рекомендованное значение — 300 секунд (5 минут).

    • Уровень доступа SQL запросов. Позволяет использовать произвольный SQL-запрос для формирования датасета.

  5. Нажмите кнопку Создать подключение.

  6. Укажите название подключения и нажмите кнопку Создать.

Примечание

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

Дополнительные настройки

Вы можете указать дополнительные параметры подключения в разделе Продвинутые настройки подключения:

  • TLS — когда опция включена, при взаимодействии с БД используется протокол HTTPS, когда выключена — HTTP.

  • CA Certificate — чтобы загрузить сертификат, нажмите кнопку Прикрепить файл и укажите файл сертификата. Когда сертификат загружен, поле отображает название файла.

  • Запрет на экспорт данных — когда опция включена, в чартах на базе этого подключения будет скрыта кнопка экспорта данных. При этом останется возможность копировать данные из чартов, а также снимать скриншоты.

Особенности работы с подключением к ClickHouse

Вы можете создавать датасеты поверх представлений (VIEW) в ClickHouse, содержащих секцию JOIN. Для этого представление должно быть создано с включенной опцией join_use_nulls. Рекомендуется выставлять настройку join_use_nulls = 1 в секции SETTINGS:

CREATE VIEW ... (    ...) AS    SELECT        ...    FROM        ...    SETTINGS join_use_nulls = 1

Также следует включать эту опцию для подзапросов raw-sql, которые используются как источник данных в датасете.

Чтобы избежать ошибок при работе с представлениями в DataLens, содержащими секцию JOIN, создайте заново все представления с настройкой join_use_nulls = 1. Пустые ячейки при этом заполнятся значениями NULL, а тип соответствующих полей преобразуется в Nullable.