跳到主要内容
跳到主要内容

Looker

Partner Integration

Looker 可以通过官方的 ClickHouse 数据源连接到 ClickHouse Cloud 或自托管的 ClickHouse 部署。

1. 收集连接信息

要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:

参数说明
HOSTPORT通常,在使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。
DATABASE NAME默认提供一个名为 default 的数据库,请填写您要连接的目标数据库名称。
USERNAMEPASSWORD默认用户名为 default。请使用适合您使用场景的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect

ClickHouse Cloud 服务 Connect 按钮

选择 HTTPS。连接信息会显示在示例 curl 命令中。

ClickHouse Cloud HTTPS 连接信息

如果您使用的是自托管 ClickHouse,则连接信息由您的 ClickHouse 管理员进行设置。

2. 创建 ClickHouse 数据源

导航到 Admin -> Database -> Connections,然后单击右上角的 “Add Connection” 按钮。

在 Looker 的数据库管理界面中添加新连接

为数据源选择一个名称,并在 “Dialect” 下拉列表中选择 ClickHouse。在表单中输入连接凭据。

在 Looker 连接表单中填写 ClickHouse 凭据

如果您使用的是 ClickHouse Cloud,或者部署需要 SSL,请确保在附加设置中启用 SSL。

在 Looker 设置中为 ClickHouse 连接启用 SSL

请先测试连接,测试通过后,再连接到新的 ClickHouse 数据源。

测试并连接到 ClickHouse 数据源

现在,您应该可以将 ClickHouse 数据源关联到 Looker 项目中。

3. 已知限制

  1. 以下数据类型默认按字符串类型处理:
    • Array - 由于 JDBC 驱动的限制,序列化无法按预期工作
    • Decimal* - 可以在模型中修改为数值类型
    • LowCardinality(...) - 可以在模型中修改为合适的数据类型
    • Enum8, Enum16
    • UUID
    • Tuple
    • Map
    • JSON
    • Nested
    • FixedString
    • Geo 类型
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. 不支持 Symmetric aggregate(对称聚合)功能
  3. 驱动程序中尚未实现 Full outer join(完全外连接)