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

Looker

Community Maintained

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

1. 收集您的连接详细信息

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

  • HOST 和 PORT:通常情况下,使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。

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

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

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中找到。选择您要连接的服务并点击 Connect

ClickHouse Cloud service connect button

选择 HTTPS,并且详细信息可以在一个示例 curl 命令中找到。

ClickHouse Cloud HTTPS connection details

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

2. 创建一个 ClickHouse 数据源

导航至 Admin -> Database -> Connections,并点击右上角的 "Add Connection" 按钮。

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

为您的数据源选择一个名称,并从方言下拉菜单中选择 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
    • 地理类型
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. 对称聚合特性 不受支持
  3. 全外连接 还没有在驱动程序中实现