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

将 Zing Data 连接到 ClickHouse

Community Maintained

Zing Data 是一个数据探索与可视化平台。Zing Data 通过 ClickHouse 提供的 JS 驱动连接到 ClickHouse。

如何连接

  1. 收集你的连接信息。

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

参数说明
HOSTPORT通常,在使用 TLS 时端口为 8443,不使用 TLS 时端口为 8123。
DATABASE NAME默认提供一个名为 default 的数据库,请填写您要连接的目标数据库名称。
USERNAMEPASSWORD默认用户名为 default。请使用适合您使用场景的用户名。

您的 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择某个服务并点击 Connect

ClickHouse Cloud 服务 Connect 按钮

选择 HTTPS。连接信息会显示在示例 curl 命令中。

ClickHouse Cloud HTTPS 连接信息

如果您使用的是自托管 ClickHouse,则连接信息由您的 ClickHouse 管理员进行设置。

  1. 下载或访问 Zing Data

    • 如需在移动端将 ClickHouse 与 Zing Data 一起使用,请在 Google Play StoreApple App Store 下载 Zing Data 应用。

    • 如需在 Web 上将 ClickHouse 与 Zing Data 一起使用,请访问 Zing Web 控制台 并创建一个账户。

  2. 添加数据源

    • 若要在 Zing Data 中操作你的 ClickHouse 数据,你需要先定义一个 datasource(数据源)。在 Zing Data 移动应用的菜单中,选择 Sources,然后点击 Add a Datasource

    • 若要在 Web 端添加数据源,点击顶部菜单中的 Data Sources,再点击 New Datasource,并在下拉菜单中选择 ClickHouse

    Zing Data 界面显示 New Datasource 按钮以及下拉菜单中的 ClickHouse 选项

  3. 填写连接信息并点击 Check Connection

    Zing Data 中的 ClickHouse 连接配置表单,包含 server、port、database、username 和 password 字段

  4. 如果连接成功,Zing 会进入表选择页面。选择所需的数据表并点击 Save。如果 Zing 无法连接到你的数据源,你会看到一条消息,提示你检查凭据并重试。如果在检查凭据并重试后仍然遇到问题,请 联系 Zing 支持。

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

  5. 一旦添加了 ClickHouse 数据源,它将在你的 Zing 组织中对所有成员可见,位于 Data Sources / Sources 选项卡下。

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

  1. 在添加好 ClickHouse 数据源之后,在 Web 端点击 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 仪表板视图,展示在仪表板布局中排列的多个可视化图表