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

将 Luzmo 与 ClickHouse 集成

Community Maintained

1. 设置 ClickHouse 连接

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

系统会要求您提供 hostusernamepassword

  • 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),以回答您客户的问题。

使用说明

  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