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

将 Luzmo 与 ClickHouse 集成

Community Maintained

1. 设置 ClickHouse 连接

要连接到 ClickHouse,请导航至 Connections page,选择 New Connection,然后在 New Connection 模态中选择 ClickHouse。

Luzmo 界面显示创建新连接对话框,已选择 ClickHouse

系统会要求您提供 hostusernamepassword

Luzmo 连接配置表单显示 ClickHouse 主机、用户名和密码字段
  • 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 的多个数据可视化

使用说明

  1. Luzmo ClickHouse 连接器使用 HTTP API 接口(通常在 8123 端口上运行)进行连接。

  2. 如果您使用带有 Distributed 表引擎的表,当 distributed_product_mode 设置为 deny 时,一些 Luzmo 图表可能会失败。然而,这仅在您将表链接到另一个表并在图表中使用该链接时才会发生。在这种情况下,请确保将 distributed_product_mode 设置为您在 ClickHouse 集群中能够接受的其他选项。如果您使用的是 ClickHouse Cloud,您可以安全地忽略此设置。

  3. 为确保例如仅 Luzmo 应用程序可以访问您的 ClickHouse 实例,强烈建议您白名单 Luzmo 的静态 IP 地址范围。我们还建议使用技术只读用户。

  4. ClickHouse 连接器当前支持以下数据类型:

    ClickHouse 类型Luzmo 类型
    UIntnumeric
    Intnumeric
    Floatnumeric
    Decimalnumeric
    Datedatetime
    DateTimedatetime
    Stringhierarchy
    Enumhierarchy
    FixedStringhierarchy
    UUIDhierarchy
    Boolhierarchy