Перейти к основному содержанию
Перейти к основному содержанию

Looker

Partner Integration

Looker может подключаться к ClickHouse Cloud или локальному развертыванию ClickHouse с помощью официального источника данных ClickHouse.

1. Получите параметры подключения

Чтобы подключиться к ClickHouse по HTTP(S), вам потребуется следующая информация:

Параметр(ы)Описание
HOST и PORTОбычно используется порт 8443 при использовании TLS или 8123 при отсутствии TLS.
DATABASE NAMEПо умолчанию существует база данных default; используйте имя базы данных, к которой вы хотите подключиться.
USERNAME и PASSWORDПо умолчанию имя пользователя — default. Используйте имя пользователя, соответствующее вашему сценарию.

Сведения о вашем сервисе ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

2. Создайте источник данных ClickHouse

Перейдите в Admin -> Database -> Connections и нажмите кнопку «Add Connection» в правом верхнем углу.

Добавление нового подключения в интерфейсе управления базами данных Looker

Задайте имя для источника данных и выберите ClickHouse в выпадающем списке диалектов. Введите свои учетные данные в форме.

Указание учетных данных ClickHouse в форме подключения Looker

Если вы используете ClickHouse Cloud или ваше развертывание требует SSL, убедитесь, что SSL включен в дополнительных настройках.

Включение SSL для подключения ClickHouse в настройках Looker

Сначала протестируйте подключение и, после успешной проверки, подключитесь к новому источнику данных ClickHouse.

Тестирование и подключение к источнику данных ClickHouse

Теперь вы сможете подключить источник данных ClickHouse к проекту Looker.

3. Известные ограничения

  1. Следующие типы данных по умолчанию обрабатываются как строки:
    • Array — сериализация работает некорректно из-за ограничений драйвера JDBC
    • Decimal* — в модели можно привести к числовому типу
    • LowCardinality(...) — в модели можно привести к соответствующему типу
    • Enum8, Enum16
    • UUID
    • Tuple
    • Map
    • JSON
    • Nested
    • FixedString
    • Географические типы данных
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. Функция симметрической агрегации не поддерживается
  3. Полное внешнее соединение (full outer join) пока не реализовано в драйвере