Подключиться
Yandex DataLens

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

Примечание

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

  • Подключение к ClickHouse выполняется только по HTTP-интерфейсу.
  • Все запросы к данным выполняются с включенным флагом join_use_nulls.

Важно

При подключении к внешнему источнику данных (который не является ресурсом 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:

  1. Перейдите на страницу подключений.

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

  3. Выберите коннектор ClickHouse.

  4. Задайте Имя подключения. Имя может быть произвольным.

  5. Выберите тип подключения:

    Укажите параметры подключения для БД 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.

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

Примечание

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