跳至主要内容

Looker

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

1. 收集连接详细信息

要使用 HTTP(S) 连接到 ClickHouse,您需要以下信息

  • 主机和端口:通常,使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。

  • 数据库名称:默认情况下,有一个名为 default 的数据库,请使用您要连接到的数据库的名称。

  • 用户名和密码:默认情况下,用户名为 default。请使用适合您的用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中找到。选择您要连接的服务,然后点击“连接”。

ClickHouse Cloud service connect button

选择“HTTPS”,详细信息可在 curl 命令示例中找到。

ClickHouse Cloud HTTPS connection details

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

2. 创建 ClickHouse 数据源

导航到“管理员”->“数据库”->“连接”,然后点击右上角的“添加连接”按钮。

Adding a new connection

为您的数据源选择一个名称,然后从方言下拉列表中选择“ClickHouse”。在表单中输入您的凭据。

Specifying your credentials

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

Enabling SSL

首先测试您的连接,完成后,连接到您的新 ClickHouse 数据源。

Enabling SSL

现在,您应该能够将 ClickHouse 数据源附加到您的 Looker 项目。

3. 已知限制

  1. 以下数据类型默认情况下将作为字符串处理
    • 数组 - 由于 JDBC 驱动程序的限制,序列化无法按预期工作
    • Decimal* - 可以在模型中更改为数字
    • LowCardinality(...) - 可以在模型中更改为正确的类型
    • Enum8、Enum16
    • UUID
    • 元组
    • 映射
    • JSON
    • 嵌套
    • FixedString
    • 地理类型
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. 对称聚合功能 不受支持
  3. 完整外部联接 尚未在驱动程序中实现