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