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

将 Zing Data 连接到 ClickHouse

Community Maintained

Zing Data 是一个数据探索和可视化平台。Zing Data 使用 ClickHouse 提供的 JS 驱动程序连接到 ClickHouse。

如何连接

  1. 收集您的连接详细信息。

要通过 HTTP(S) 连接到 ClickHouse,您需要以下信息:

  • HOST 和 PORT:通常情况下,使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。

  • 数据库名称:默认情况下,有一个名为 default 的数据库,请使用您要连接的数据库名称。

  • 用户名和密码:默认情况下,用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中找到。选择您要连接的服务并点击 Connect

ClickHouse Cloud service connect button

选择 HTTPS,并且详细信息可以在一个示例 curl 命令中找到。

ClickHouse Cloud HTTPS connection details

如果您使用自管理的 ClickHouse,连接详细信息由您的 ClickHouse 管理员设置。

  1. 下载或访问 Zing Data

  2. 添加数据源

    • 要使用 Zing Data 与您的 ClickHouse 数据进行交互,您需要定义一个 datasource。在 Zing Data 的移动应用菜单中,选择 Sources,然后单击 Add a Datasource

    • 要在网页上添加数据源,请单击顶部菜单中的 Data Sources,然后单击 New Datasource,从下拉菜单中选择 Clickhouse

    Zing Data 界面,显示新增数据源按钮和下拉菜单中的 ClickHouse 选项

  3. 填写连接详细信息,然后单击 Check Connection

    Zing Data 中的 ClickHouse 连接配置表单,包含服务器、端口、数据库、用户名和密码字段

  4. 如果连接成功,Zing 将继续进行表选择。选择所需的表,然后单击 Save。如果 Zing 无法连接到您的数据源,您将看到一条消息,要求您检查凭据并重试。如果在检查凭据并重试后仍然遇到问题,请 在这里联系 Zing 支持。

    Zing Data 表选择界面,显示可用的 ClickHouse 表及复选框

  5. 一旦 Clickhouse 数据源被添加,它将可供您 Zing 组织中的所有人使用,位于 Data Sources / Sources 标签下。

在 Zing Data 中创建图表和仪表板

  1. 在添加了 Clickhouse 数据源后,点击网页上的 Zing App,或在移动设备上点击数据源以开始创建图表。

  2. 在表列表中单击一个表以创建图表。

    Zing Data 界面,显示可用 ClickHouse 表的表列表

  3. 使用可视查询构建器选择所需的字段、聚合等,然后单击 Run Question

    Zing Data 可视查询构建器界面,包含字段选择和聚合选项

  4. 如果您熟悉 SQL,您也可以编写自定义 SQL 来运行查询并创建图表。

    Zing Data 中的 SQL 编辑模式,显示 SQL 查询编写界面
    Zing Data 中的 SQL 查询结果,以表格格式显示数据
  5. 示例图表如下面所示。可以使用三点菜单保存该问题。您可以对图表进行评论,标记团队成员,创建实时警报,更改图表类型等。

    Zing Data 中的示例图表可视化,显示来自 ClickHouse 的数据以及选项菜单

  6. 可以使用主屏幕上 Dashboards 下的 "+" 图标创建仪表板。现有问题可以拖拽以在仪表板上显示。

    Zing Data 仪表板视图,显示多种可视化内容排列在仪表板布局中