Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Решения
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex DataLens
  • Начало работы
  • Сценарии использования
    • Все сценарии
    • Визуализация данных из CSV-файла
    • Визуализация данных из базы данных ClickHouse
    • Визуализация данных из Metriсa
    • Визуализация данных из Metriсa Logs API
    • Публикация в DataLens Public диаграммы с картой на основе CSV-файла
    • Визуализация данных из AppMetrica
    • Визуализация геоданных из CSV-файла
    • Визуализация данных из базы данных ClickHouse с геослоями из Marketplace
    • Визуализация данных из статистики подкастов Яндекс.Музыки
  • Пошаговые инструкции
    • Все инструкции
    • Работа с подключениями
      • Создание подключения к ClickHouse
      • Создание подключения к файлу CSV
      • Создание подключения к MySQL
      • Создание подключения к PostgreSQL
      • Создание подключения к MS SQL Server
      • Создание подключения к Oracle Database
      • Создание подключения к Metrica API
      • Создание подключения к Metrica Logs API
      • Создание подключения к AppMetrica
      • Управление доступом к подключению
    • Работа с датасетами
      • Создание датасета
      • Создание поля данных
      • Создание вычисляемого поля данных
      • Обновление полей в датасете
      • Материализация датасета
      • Управление доступом к датасету
      • Управление доступом к строкам данных
    • Работа с чартами
      • Создание линейной диаграммы
      • Создание диаграммы с областями
      • Создание круговой диаграммы
      • Создание столбчатой диаграммы
      • Создание линейчатой диаграммы
      • Создание карты
      • Создание таблицы
      • Создание сводной таблицы
      • Публикация чарта
      • Управление доступом к чарту
    • Работа с дашбордами
      • Создание дашборда
      • Добавление чарта на дашборд
      • Добавление селектора на дашборд
      • Публикация дашборда
      • Управление доступом к дашборду
    • Работа с правами доступа
      • Назначение прав доступа
      • Удаление прав доступа
      • Запрос прав доступа
  • Концепции
    • Обзор сервиса
    • Подключение
    • Типы данных
    • Датасет
      • Обзор
      • Модель данных
      • Настройки датасета
    • Чарт
    • Дашборд
    • Использование Markdown в DataLens
    • DataLens Public
    • Вычисляемые поля
    • Marketplace
    • Резервное копирование в DataLens
    • Квоты и лимиты
  • Управление доступом
    • Управление доступом к DataLens
    • Управление доступом на уровне строк данных
  • Правила тарификации
    • Действующие правила
    • Архив
      • Правила до 1 марта 2021 года
  • Справочник функций
    • Все функции
    • Агрегатные функции
      • Обзор
      • ALL_CONCAT
      • ANY
      • ARG_MAX
      • ARG_MIN
      • AVG
      • AVG_IF
      • COUNT
      • COUNTD
      • COUNTD_APPROX
      • COUNTD_IF
      • COUNT_IF
      • MAX
      • MEDIAN
      • MIN
      • QUANTILE
      • QUANTILE_APPROX
      • STDEV
      • STDEVP
      • SUM
      • SUM_IF
      • TOP_CONCAT
      • VAR
      • VARP
    • Функции даты и времени
      • Обзор
      • DATEADD
      • DATEPART
      • DATETRUNC
      • DAY
      • DAYOFWEEK
      • HOUR
      • MINUTE
      • MONTH
      • NOW
      • SECOND
      • TODAY
      • WEEK
      • YEAR
    • Географические функции
      • Обзор
      • GEOCODE
      • GEOINFO
      • TOPONYM_TO_GEOPOINT
      • TOPONYM_TO_GEOPOLYGON
    • Логические функции
      • Обзор
      • CASE
      • IF
      • IFNULL
      • ISNULL
      • ZN
    • Функции разметки
      • Обзор
      • BOLD
      • ITALIC
      • MARKUP
      • URL
    • Математические функции
      • Обзор
      • ABS
      • ACOS
      • ASIN
      • ATAN
      • ATAN2
      • CEILING
      • COS
      • COT
      • DEGREES
      • DIV
      • EXP
      • FLOOR
      • GREATEST
      • LEAST
      • LN
      • LOG
      • LOG10
      • PI
      • POWER
      • RADIANS
      • ROUND
      • SIGN
      • SIN
      • SQRT
      • SQUARE
      • TAN
    • Операторы
      • Обзор
      • AND
      • BETWEEN
      • IN
      • IS FALSE
      • IS TRUE
      • LIKE
      • NOT
      • OR
      • Вычитание (-)
      • Деление (/)
      • Остаток (%)
      • Отрицание (-)
      • Сложение и конкатенация (+)
      • Сравнение
      • Степень (^)
      • Умножение (*)
    • Строковые функции
      • Обзор
      • ASCII
      • CHAR
      • CONCAT
      • CONTAINS
      • ENDSWITH
      • FIND
      • ICONTAINS
      • IENDSWITH
      • ISTARTSWITH
      • LEFT
      • LEN
      • LOWER
      • LTRIM
      • REGEXP_EXTRACT
      • REGEXP_EXTRACT_NTH
      • REGEXP_MATCH
      • REGEXP_REPLACE
      • REPLACE
      • RIGHT
      • RTRIM
      • SPACE
      • SPLIT
      • STARTSWITH
      • SUBSTR
      • TRIM
      • UPPER
      • UTF8
    • Функции для работы с временными рядами
      • Обзор
      • AGO
      • AT_DATE
    • Функции преобразования типов
      • Обзор
      • BOOL
      • DATE
      • DATETIME
      • DATETIME_PARSE
      • DATE_PARSE
      • DB_CAST
      • FLOAT
      • GEOPOINT
      • GEOPOLYGON
      • INT
      • STR
    • Оконные функции
      • Обзор
      • AVG
      • AVG_IF
      • COUNT
      • COUNT_IF
      • LAG
      • MAVG
      • MAX
      • MCOUNT
      • MIN
      • MMAX
      • MMIN
      • MSUM
      • RANK
      • RANK_DENSE
      • RANK_PERCENTILE
      • RANK_UNIQUE
      • RAVG
      • RCOUNT
      • RMAX
      • RMIN
      • RSUM
      • SUM
      • SUM_IF
    • Поддержка функций
  • Вопросы и ответы
  1. Пошаговые инструкции
  2. Работа с подключениями
  3. Создание подключения к ClickHouse

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

  • Подключение к ClickHouse
  • Особенности работы с подключением к 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:

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

Примечание

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

Особенности работы с подключением к 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.

В этой статье:
  • Подключение к ClickHouse
  • Особенности работы с подключением к ClickHouse
Language / Region
Вакансии
Политика конфиденциальности
Условия использования
Брендбук
© 2021 ООО «Яндекс.Облако»