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

Looker

Partner Integration

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

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

To connect to ClickHouse with HTTP(S) you need this information:

Parameter(s)Description
HOST and PORTTypically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAMEOut of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORDOut of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS. Connection details are displayed in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

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) пока не реализовано в драйвере