快速入门

前提条件

注册火山账号，并完成企业实名认证。

快速使用 ByteHouse

1. 开启服务

单击火山引擎控制台左上角，展示 产品与服务 列表，选择 “ByteHouse 企业版”。
首次通过火山账号进入 ByteHouse 企业版，会开启 ByteHouse 服务，同时系统会自动生成 ByteHouse 初始服务密码。
在界面右上角点击用户图标，在下拉菜单中单击“ByteHouse 密码”，即可查询系统给用户生成的临时服务密码。

2. 新建集群

使用 ByteHouse 企业版，首先需要新建一个 ByteHouse 集群。该集群提供了完整的 ByteHouse 服务。
下面我们来开始新建集群：

1. 登录火山引擎，进入 ByteHouse 企业版控制台。

2. 单击 **新建集群 **按钮，进入新建集群配置界面。
   

3. 接下来，选择创建新集群的选项。您需要根据您的实际数据量情况选择合适的计算与存储资源：
   

   参数	说明
   地域
   地域	火山引擎数据中心的地理位置区域，根据地理位置的不同划分了不同的地域。在实例创建后，实例的地域不可更改。 具体信息可参见@
   可用区	是一个或多个物理数据中心的集合。在同一个地域内，可用区的电力网络相互独立，即一个可用区故障时不会影响到同地域内的其他可用区。不同地域的可用区相互隔离，相同地域的可用区可以互通。
   付费信息
   计费类型	ByteHouse 企业版目前仅支持包年包月计费模式。计费详情参考：定价规则。
   计算资源
   规格	单个计算节点的规格，可选 4 核 16 GB - 64 核 256 GB。计算规格和集群的性能正相关。
   副本模式	单副本： 即 ByteHouse 集群的一个分片（Shard）仅含一个节点（Node），单节点故障、集群重启时，集群会不可查询，且不可导入。 双副本： 即 ByteHouse 集群的一个分片（Shard）含两个节点（Node），实现高可用，即便单节点故障、集群重启时，集群仍能正常提供服务。
   节点数量	为集群的节点数量，如果选择了双副本，则节点数量必须为偶数。
   存储资源
   单节点存储空间	单个节点的数据盘空间，即 ByteHouse 可用的空间。 在单副本下，集群的总体存储为 单节点存储空间 * 节点数，容量为单节点存储空间 * 节点数。 在双副本下，集群的总体存储为 单节点存储空间 * 节点数，容量为单节点存储空间 * 节点数/2。
   冷热分层存储（Beta）	对于访问频次较低的数据，存储在较低价的冷数据存储中（即对象存储），以达到节省存储成本的目的。冷存储单独计费，您也可以在后续再开启此功能。详见冷热分层存储。
   网络信息
   私有网络	私有网络（VPC，Virtual Private Cloud）为云上资源构建隔离的、自主配置和管理的虚拟网络环境。详见私有网络。 此处，建议将 ByteHouse 集群和上游数据源（如 Kafka，MySQL 等）配置在一个 VPC 中，便于网络互访。
   子网	子网是私有网络内的IP地址块，创建私有网络后，通过创建子网可以将私有网络划分为一个或多个网络模块。详见子网文档。
   安全组	安全组是一个逻辑意义上的分组，为同一个私有网络内具有相同安全保护需求并相互信任的云服务器提供访问策略，是重要的网络安全隔离手段。详见安全组。 需保证当前安全组对于访问 ByteHouse 的 8123，9000 端口放行。
   购买时长
   购买时长	可选择 1 个月 - 3 年。
   自动续订	在集群到期前7天，系统将会自动从您的账户余额中扣除续费费用。详见计费方式。
   集群
   集群名称	控制台上展示的集群名称，也会作为 ByteHouse 配置文件内的集群名。集群名在账户内唯一。
   描述	输入集群的描述信息，方便后续管理。

4. 在选择完所有信息后，勾选“我已阅读并同意”相关协议，单击确认订单，即完成集群的创建。

5. 集群进入“运行中”状态后，即可正常访问。

3. 导入用户

若需要让子用户也激活 ByteHouse 企业版，需要进行如下操作：

1. 主账号给子用户关联 ByteHouse 企业版 IAM 策略。
   1. 登录 访问控制 IAM 控制台。
   2. 在左侧导航栏，选择身份管理 > 用户。
   3. 在用户列表中，找到需要设置权限的用户名，单击对应操作列下的管理。
   4. 在用户详情页面，选择权限 > 全局权限页签，单击添加权限。
   5. 在添加权限面板的搜索框中输入 ByteHouseCEFullAccess 并添加。
   6. 完成后，单击确定。
2. 子用户 通过 IAM 登录页面进入 ByteHouse 企业版控制台。

4. GUI 访问集群

将右上角的产品模式切换到“数据管理与查询”。

切换后，在集群选择框中切换到对应的集群，即可通过 GUI 对集群进行以下操作：

• 数据管理：支持库表创建、分区管理。
• 数据导入：支持从 Kafka/对象存储 导入数据到 ByteHouse。
• 数据查询：支持对集群发起查询，以及浏览查询历史，诊断大查询。

5. Client 访问集群

在任何一台和 ByteHouse 集群网络联通的云服务器上安装 clickhouse-client，并执行命令，即可实现连接集群：

clickhouse-client --host <HOSTNAME> \
                  --user <USERNAME> \
                  --password <PASSWORD>

步骤和参数配置参考：ClickHouse Client。