将 Luzmo 与 ClickHouse 集成
1. 设置 ClickHouse 连接
要连接到 ClickHouse,请导航至 Connections page,选择 New Connection,然后在 New Connection 模态中选择 ClickHouse。

系统会要求您提供 host,username 和 password:

- Host:这是您 ClickHouse 数据库暴露的主机。请注意,这里仅允许使用
https
,以安全地传输数据。主机 URL 的结构应为:https://url-to-clickhouse-db:port/database
默认情况下,插件将连接到 'default' 数据库和 443 端口。通过在 '/' 后提供数据库,您可以配置要连接的数据库。 - Username:用于连接到您的 ClickHouse 集群的用户名。
- Password:连接到您的 ClickHouse 集群的密码。
请参考我们开发者文档中的示例,了解如何通过我们的 API 创建与 ClickHouse 的连接。
2. 添加数据集
连接到 ClickHouse 后,您可以按照 这里 的说明添加数据集。您可以选择一个或多个 ClickHouse 中可用的数据集,并在 Luzmo 中 链接 它们,以确保可以在仪表板中一起使用。同样,请务必查看有关 准备您的数据以进行分析 的文章。
有关如何使用我们的 API 添加数据集的信息,请参考 我们开发者文档中的此示例。
您现在可以使用您的数据集构建精美的(嵌入式)仪表板,甚至驱动 AI 数据分析师 (Luzmo IQ),以回答您客户的问题。

使用说明
-
Luzmo ClickHouse 连接器使用 HTTP API 接口(通常在 8123 端口上运行)进行连接。
-
如果您使用带有
Distributed
表引擎的表,当distributed_product_mode
设置为deny
时,一些 Luzmo 图表可能会失败。然而,这仅在您将表链接到另一个表并在图表中使用该链接时才会发生。在这种情况下,请确保将distributed_product_mode
设置为您在 ClickHouse 集群中能够接受的其他选项。如果您使用的是 ClickHouse Cloud,您可以安全地忽略此设置。 -
为确保例如仅 Luzmo 应用程序可以访问您的 ClickHouse 实例,强烈建议您白名单 Luzmo 的静态 IP 地址范围。我们还建议使用技术只读用户。
-
ClickHouse 连接器当前支持以下数据类型:
ClickHouse 类型 Luzmo 类型 UInt numeric Int numeric Float numeric Decimal numeric Date datetime DateTime datetime String hierarchy Enum hierarchy FixedString hierarchy UUID hierarchy Bool hierarchy