本文介绍了 ByteHouse 进行配置变更的方法和注意事项。
ByteHouse 配置变更一般分为两种：

• 垂直变配（scale up / down）：指调整集群中每个节点的规格，来增加/减少集群的总体性能。

• 水平变配（scale out / in）：指在集群中新增或减少节点，来增加/减少集群的总体性能。

我们可以通过下表直接对比水平变配和垂直变配的差异：

注意事项

1. 目前水平扩容功能为 Beta 状态，在扩容关键数据前，建议做好数据备份；
2. 每个旧节点需要预留存储的容量为最大的一张表的容量，例如，表的总大小为 100GB，当前10个节点，缩容为5个节点，则需要在每个旧节点预留 100GB / 5 = 20GB 以上的存储扩建；
3. 水平变配和重分布期间，禁止使用 DDL / DML 语句调整元数据，如新建库表、调整表结构、修改用户等；
4. 扩容时间与节点数、网络速率和磁盘速率都有关系，ByteHouse 产品界面上显示的时间仅供预估参考。
5. 数据重分布期间，表会逐一进入只读状态，同时集群的计算和 IO 负载会较高，预估读性能会下降且不稳定。

垂直变配

前提条件

权限要求：集群管理员，或系统管理员；

具体操作

1. 在 ByteHouse 界面进入： 集群管理 > 集群列表 > 更改配置；

2. “更改规格类型”选择“垂直变配”；

3. 调整计算资源的规格和存储资源的大小；

4. 产生的费用变化实时显示在界面上，更多信息可参考 变更规格计费说明；
5. 点击确定按钮，节点滚动重启，之后配置生效；

水平变配【Beta】

前提条件

权限要求：集群管理员，或系统管理员；
版本要求：ByteHouse 2.2.1.130 及以上版本 （集群管理 > 集群列表 > 集群详情 > 基本信息 > 引擎版本）

操作步骤

1. 在ByteHouse界面进入：集群管理 > 集群列表 > 更改配置；

2. “更改规格类型”选择“水平变配”；

3. 选择集群更配后节点数，支持增加节点（水平扩容），也支持减少节点（水平缩容）；
4. 根据情况判断是否需要进行数据重分布：
   1. 对于增加节点的场景，可勾选“更改规格后数据将进行重分布”，并选择重分布所有表；或仅重分布部分表，支持重分布的表的类型，请参考数据重分布中的内容；
   2. 对于减少节点的场景：必选数据重分布，并重分布所有表；
5. 界面会给出预估时间。用户可以根据实际情况，对下游业务发出扩容公告。
6. 产生的费用变化，参考 变更规格计费说明；
7. 提交扩容任务，集群进入“运维任务中”状态。后台执行两阶段任务：
   1. 扩容情况下：
      1. 阶段1，新增节点。实际在进行新节点的初始化，并在新节点上新建元数据，此阶段不影响集群读写和性能；
      2. 阶段2，逐一重分布之前选中的表，此阶段正在重分布的表会金进入只读状态，同时集群的计算和 IO 负载会较高，预估读性能会下降且不稳定。如果部分表重分布失败，不会影响扩容，您可以稍后再使用“重分布”功能独立重分布这些表。
   2. 缩容情况下
      1. 阶段1，逐一重分布所有表，此阶段正在重分布的表会金进入只读状态，同时集群的计算和 IO 负载会较高，预估读性能会下降且不稳定。如果部分表重分布失败，则不会继续缩容，任务终止；
      2. 阶段2，减少节点。此阶段不影响集群读写和性能；
8. 上述步骤完成，集群恢复“运行中”状态。