Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Looker

合作伙伴集成

Looker 可通过官方 ClickHouse 数据源连接到 ClickHouse Cloud 或本地部署。

收集您的连接详细信息

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

Parameter(s) Description
HOST and PORT 通常,使用 TLS 时端口为 8443;不使用 TLS 时端口为 8123。
DATABASE NAME 默认情况下,存在一个名为 default 的数据库。请使用你要连接的数据库名称。
USERNAME and PASSWORD 默认情况下,用户名为 default。请根据你的使用场景使用相应的用户名。

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务,然后点击 Connect

ClickHouse Cloud 服务连接按钮

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

ClickHouse Cloud HTTPS 连接信息

如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。

创建 ClickHouse 数据源

前往 Admin -> Database -> Connections,然后点击右上角的 “Add Connection” 按钮。

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

为数据源命名,并在 dialect 下拉菜单中选择 ClickHouse。然后在表单中输入您的凭据。

在 Looker 连接表单中指定您的 ClickHouse 凭据

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

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

请先测试连接;完成后,再连接到新的 ClickHouse 数据源。

测试并连接到 ClickHouse 数据源

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

已知限制

  1. 默认情况下,以下数据类型会被作为字符串处理:
    • Array - 由于 JDBC 驱动的限制,serialization 无法按预期运行
    • Decimal* - 可在模型中改为数值
    • LowCardinality(…) - 可在模型中改为适当的类型
    • Enum8, Enum16
    • UUID
    • Tuple
    • Map
    • JSON
    • Nested
    • FixedString
    • Geo 类型
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. 不支持对称聚合功能
  3. 驱动尚未实现完全外连接
Navigation