将 Luzmo 与 ClickHouse 集成

1. 设置 ClickHouse 连接

要建立与 ClickHouse 的连接，请导航到连接页面，选择新建连接，然后从新建连接模态框中选择 ClickHouse。

您将被要求提供主机、用户名和密码

• 主机：这是您的 ClickHouse 数据库暴露的主机。请注意，此处仅允许 https，以便通过网络安全地传输数据。主机 URL 的结构期望为：https://url-to-clickhouse-db:port/database 默认情况下，插件将连接到“default”数据库和 443 端口。通过在“/”后提供数据库，您可以配置要连接的数据库。
• 用户名：将用于连接到您的 ClickHouse 集群的用户名。
• 密码：用于连接到您的 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 类型
   UInt	数值型
   Int	数值型
   浮点型	数值型
   Decimal	数值型
   日期	日期时间
   DateTime	日期时间
   字符串	层级
   Enum	层级
   FixedString	层级
   UUID	层级
   布尔型	层级