Looker 支持 ClickHouse 版本 0.2 及更高版本。
加密网络流量
Looker 强烈建议对 Looker 应用和数据库之间的网络流量进行加密。请考虑使用启用安全数据库访问文档页面中所述的其中一个选项。
若要在服务器端启用 SSL 加密,请参阅 ClickHouse 文档。
用户和安全
首先,在 ClickHouse 服务器上配置 Looker 用户。ClickHouse 数据库用户不是使用传统的 CREATE USER
命令创建的。按照 ClickHouse 访问权限文档,在 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 的管理部分中,选择连接,然后点击添加连接。
填写连接详情。大多数设置是大多数数据库方言通用的设置。如需了解相关信息,请参阅将 Looker 连接到数据库文档页面。下面将介绍部分设置:
- Dialect:ClickHouse。
- 主机:可访问的主机名。
- 端口:可通过 HTTP(S) 访问 ClickHouse 服务的端口。
- 默认情况下,HTTP 连接将使用 8123,HTTPS 将使用 8443。
- 默认情况下,ClickHouse 命令行客户端会使用端口 9000 和 9440,但 Looker 无法使用这些端口连接到 ClickHouse。
- 您的 ClickHouse 管理员可能通过 ClickHouse 配置中的
http_port/https_port
设置选择了备用端口。向您的 ClickHouse 管理员询问适合您本地配置的设置。
- 数据库:数据库名称(必须是
users.xml
文件中允许的数据库之一)。 - 用户名:数据库用户名。
- 密码:数据库密码。
- 更多 JDBC 参数:(可选)其他 JDBC 字符串参数。
- 数据组和 PDT 维护时间表:ClickHouse 不支持 PDT,因此可以忽略此问题。
- SSL:勾选以通过 SSL 连接到 ClickHouse。
- Verify SSL(可选):选中此项即可对 ClickHouse 服务器强制执行严格的主机名验证。请仅在使用由公认的证书授权机构签名的 SSL 证书时选中。如果您使用的是自签名 SSL 证书,请勿选中此复选框。
如需验证连接是否成功,请点击测试。如需了解问题排查信息,请参阅测试数据库连接文档页面。
要保存这些设置,请点击连接。
功能支持
为了让 Looker 支持某些功能,您的数据库方言也必须支持这些功能。
自 Looker 23.8 起,ClickHouse 支持以下功能:
功能 | 是否支持? |
---|---|
支持级别 | 支持 |
Looker (Google Cloud Core) | 是 |
对称聚合 | 否 |
派生表 | 是 |
永久性 SQL 派生表 | 否 |
永久性原生派生表 | 否 |
稳定版观看次数 | 否 |
查询终止 | 是 |
基于 SQL 的数据透视 | 否 |
时区 | 否 |
SSL | 是 |
小计 | 否 |
JDBC 附加参数 | 是 |
区分大小写 | 是 |
位置类型 | 是 |
列表类型 | 是 |
百分位 | 是 |
不同百分位 | 否 |
SQL Runner 显示进程 | 是 |
SQL Runner 描述表 | 是 |
SQL Runner 显示索引 | 否 |
SQL Runner 选择 10 | 是 |
SQL 运行程序计数 | 是 |
SQL 说明 | 否 |
OAuth 凭据 | 否 |
上下文评论 | 是 |
连接池 | 否 |
HLL 素描 | 否 |
总体认知度 | 否 |
PDT 增幅 | 否 |
毫秒 | 否 |
微秒 | 否 |
具体化视图 | 否 |
唯一计数 | 否 |