Skip to main content

​
1. 设置 ClickHouse 连接

要连接到 ClickHouse，请前往 Connections 页面，选择 New Connection，然后在 New Connection 连接弹窗中选择 ClickHouse。 系统会要求你提供 host、username 和 password：
  • Host：这是暴露你的 ClickHouse 数据库的主机地址。请注意，为了通过网络安全传输数据，这里仅允许使用 https。host 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 连接器当前支持以下数据类型：
最后修改于 2026年7月3日