ClickHouse

Looker 支持 ClickHouse 0.2 及更高版本。

加密网络流量

Looker 强烈建议加密 Looker 应用与数据库之间的网络流量。考虑启用安全的数据库访问文档页面上介绍的方案之一。

如需在服务器端启用 SSL 加密，请参阅 ClickHouse 文档。

用户和安全

首先，在 ClickHouse 服务器上配置 Looker 用户。ClickHouse 数据库用户不是使用传统的 CREATE USER 命令创建的。按照 ClickHouse Access Rights 文档在 users.xml 文件中配置 users 部分。下面是一个基本示例：

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

此外，在此文件中配置适当的数据库访问权限：

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

添加连接

在 Looker 的管理部分，选择连接，然后点击添加连接。

填写连接详细信息（如需了解详情，请参阅将 Looker 连接到数据库文档页面）：

  • 方言：ClickHouse。
  • 主机：可访问的主机名。
  • Port：可通过 HTTP(S) 访问 ClickHouse 服务的端口。
    • 默认情况下，HTTP 连接使用 8123，而 HTTPS 使用 8443。
    • 默认情况下，ClickHouse 命令行客户端会使用端口 9000 和 9440，但 Looker 无法使用这些端口连接到 ClickHouse。
    • 您的 ClickHouse 管理员可能已使用 ClickHouse 配置中的 http_port/https_port 设置选择了备用端口。请向您的 ClickHouse 管理员询问适合您本地配置的设置。
  • 数据库：数据库名称（必须是 users.xml 文件中允许的数据库之一）。
  • 用户名：数据库用户名。
  • Password（密码）：数据库密码。
  • Additional Params：（可选）其他 JDBC 字符串参数。
  • PDT 和数据组维护时间表：ClickHouse 不支持 PDT，因此可以忽略它。
  • SSL：选中后可通过 SSL 连接到 ClickHouse。
  • Verify SSL（验证 SSL）：选中（可选）在 ClickHouse 服务器上强制执行严格的主机名验证。仅当您使用的是由公认受信任的证书授权机构签名的 SSL 证书时，才应勾选此选项。如果您使用的是自签名 SSL 证书，请勿将其选中。

功能支持

为了让 Looker 支持某些功能，您的数据库方言也必须支持这些功能。

在最新版 Looker 中，ClickHouse 支持以下 Looker 功能：

后续步骤

完成数据库配置后，从 Looker 连接到数据库。