You need to enable JavaScript to run this app.
导航
ByteHouse CE
最近更新时间:2025.06.27 17:49:46首次发布时间:2023.02.02 14:58:55
我的收藏
有用
有用
无用
无用

本文为您介绍如何接入 ByteHouse CE 来创建数据集,以进行 BI 分析和报表展示。

前提条件

用户需要有 ByteHouse CE 企业版 账号。

准备工作
  1. 参考 ByteHouse企业版快速入门,完成购买开通、创建集群、创建库表及数据导入的操作。
  2. (仅限Saas版本)用户需将“DataWind 访问的公网 IP” 填入白名单设置区域,方可在Saas环境接入数据。”DataWind 访问的公网 IP”可查看数据连接概述。具体步骤可参见 ByteHouse CE 白名单管理
  3. 获取服务器。进入「集群管理」-「集群列表」页面,在网络信息栏获取服务器域名。
    Image
  4. 获取端口。可参考 ByteHouse CE 集群连接信息
  5. 获取用户名和密码。点击「账号管理」,可查看用户名和连接密码。
    Image
  6. (仅限Saas版本)获取 VPC ID。点击「集群管理」-「集群列表」,在「网络信息」栏获取 VPC ID。
    Image

从数据连接新建
  1. 进入火山引擎,点击进入到某个具体项目下,点击数据准备,在下拉列表找到数据连接,点击数据连接。
    Image
  2. 在页面中选择 ByteHouse CE 。
    Image
  3. 填写所需的基本信息,并进行测试连接,连接成功后点击保存。
    Image
    • 相关参数配置说明如下:

      参数

      配置说明

      数据连接名称

      新建数据连接的名称,用于在系统中区分不同数据库的连接。默认为Bytehouse_CE_时间戳。可对名称进行修改,但请输入规范的名称,只允许中文、英文、数字和下划线的组合,前后不能包含空格。

      服务器

      获取方式见准备工作

      端口

      获取方式见准备工作

      用户名

      获取方式见准备工作

      密码

      获取方式见准备工作

      权限模式

      支持读和写两种方式。

      • 读:仅获取数据源中的数据,不能修改、添加或删除数据。
      • 写:用户需要通过可视化建模向数据连接中写入数据,需具备数据的操作权限。

      vpcMode 和 VPC ID

      仅 Saas 版本需要填写这两项参数。
      Image

      • vpcMode:如果用户需要通过火山云内网连接,选「是」;其余情况选「否」。
      • VPC ID:当vpcMode为「是」时需填写,获取方式见准备工作

从数据集新建
  1. 进入火山引擎,点击数据准备-->数据集,选择左上角「新建」按钮,新建数据集。
    Image
  2. 选择数据连接的时候,点击新建配置。
    Image
  3. 后续步骤与上述从数据连接新建的2、3步一致,在完成配置之后会停在数据集选择数据连接的弹出框中,即可直接进行下一步的数据集创建。

后续步骤:创建数据集
  1. 使用之前创建好的数据连接创建数据集:点击数据准备-->数据集,选择左上角「新建」按钮进行数据集的新建。
    Image
  2. 搜索或下拉选择之前新建好的数据连接。
    Image

常见问题

实名认证

如未进行实名认证,则无法正常访问火山引擎 ByteHouse 企业版控制台,需要完成实名认证
Image

获取数据库局域网 IP 与 VPC ID

说明

如果您购买的是Saas版本,需要通过VPC模式使用局域网IP连接,并且连接的数据源地区为华北2时,才需要关注获取数据库局域网 IP 与 VPC ID。

获取数据库局域网 IP

获取数据库局域网 IP 有两种方法,方法一是通过 ping 局域网域名查询,方法二是通过 VPC 下的网卡管理查询,下文将为您详细介绍。

通过 ping 局域网域名查询

  1. 打开命令行工具:在 Windows 系统中,按下Windows+R键,输入cmd并回车,打开命令提示符窗口;在 macOS 或 Linux 系统中,打开终端应用程序。
  2. ping 局域网域名:输入ping [数据库局域网域名],例如ping mysql-server.local,按下回车键。命令执行后,会显示域名对应的 IP 地址,这个 IP 地址就是数据库服务器在局域网中的 IP 地址。

通过 VPC 的网卡管理查询

以 MySQL 为例说明,其他产品如 PostgreSQL、负载均衡、ECS 等环境搭建的数据库同理。

  1. 进入 MySQL 的实例列表界面,点击查看“实例信息”。

  2. 进入网卡界面,在私网 IP 地址一栏中,可以查看到局域网 IP。

获取VPC ID

用户只能通过 VPC 的网卡管理查询 VPC ID。
以 MySQL 为例说明,其他产品如 PostgreSQL、负载均衡、ECS 等环境搭建的数据库同理。

  1. 进入 MySQL 的实例列表界面,点击查看“实例信息”。

  2. 将下图所示的“基本信息”中的「ID」复制,即可获得 VPC ID。

填写服务器 IP 和 VPC ID

  1. 进入数据连接配置界面,将复制的「ID」填写到A「VPC ID」一栏。

  2. 复制局域网 IP,并将此 IP 填写到数据连接界面中 B「服务器」一栏。