ByteHouse 企业版支持修改已创建集群的配置，支持通过垂直变配或水平变配两种方式对集群规格或节点数进行修改，本文为您介绍 ByteHouse 进行配置变更的方法和注意事项。

ByteHouse 配置变更一般分为两种：垂直变配、水平变配。

• 如需使用水平变配的节点缩容（减少节点数）功能，请提交工单或联系 ByteHouse 团队获取白名单权限。
• 仅具有 ClusterAdmin 或 SystemAdmin 角色的用户可执行集群变配操作。

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

操作步骤

1. 在 ByteHouse 企业版控制台上，单击顶部集群管理，单击集群列表，单击对应集群操作列的更改规格。
   

2. 在更改规格页面，将“更改规格类型”选择为“垂直变配”。
   

   参数	配置说明
   计算资源	配置垂直变配后的节点规格类型和大小，支持扩容和缩容操作。
   存储资源	调整单节点存储空间。调整规则如下： 存储空间只允许扩容，不支持缩容，即不支持降低存储空间。 最大 64000 GiB。 调整时仅支持按照 100 GiB 增减，例如，输入 120 后会自动调整为 200。
   扩缩容时间	界面会给出扩缩容的预估时间。您可以根据实际情况，对下游业务发出公告。 注意 实际耗时与节点数、网络速率和磁盘速率都有关系，此处界面上显示的时间仅供预估参考。
   变更费用	为您展示此次变更配置产生的费用变化，参考 变更规格计费说明。

3. 单击页面下方的确认，页面跳转至变配订单确认页面，根据页面提示完成变配付费，集群即开始变配。
   

4. 配置完成后，集群恢复“正在运行”状态，更改的配置将生效。

前提条件

请确保您使用的 ByteHouse 引擎版本为 v2.2.1.130 及以上版本 。如果版本过低，界面会提示水平扩容功能无法使用。

您可登录 ByteHouse 企业版控制台，单击顶部集群管理，进入集群列表，单击目标集群名称，在基本信息页面中查看您使用的引擎版本。

操作步骤

1. 在 ByteHouse 企业版控制台上，单击顶部集群管理，单击集群列表，单击对应集群操作列的更改规格。
   

2. 在更改规格页面，将“更改规格类型”选择为“水平变配”。
   

   参数	配置说明
   水平变配类型	当前支持扩缩节点数量、副本数量两种方式。 节点数量：修改节点数，副本数不变。 副本数量：修改副本数，节点数会根据修改后的副本数自动变更。
   计算资源	配置水平变配后的节点/副本数量。 水平变配场景下支持增加节点数（扩容），也支持减少节点数（缩容）。 如果您增加了节点数量。 扩容时，会自动重分布所有表数据，如果部分表重分布失败，不会影响扩容，您可以稍后再使用“重分布”功能独立重分布这些表。 若当前集群存在 HaUniqueMergeTree 表，扩容后表拓扑不变，新节点无数据，导入任务无影响；或者您需要使用扩容后更高的读写性能，建议您在扩容完成后手动进行数据重分布。 手动重分布的操作详情请参见数据重分布。 如果您减少了节点数，则还需在页面下方配置重分布设置、高级设置。
   重分布设置 & 高级设置 （可选）	如果您减少了节点数，您还需配置重分布设置和高级设置。 重分布：根据情况选择是否打开重分布设置开关。打开开关后，您可以在页面下方查看当前需要重分布的所有表，水平缩容配置提交后，完成规格变更后所有数据表即自动重分布。 说明 当前仅支持重分布所有表，不可重分布部分表数据（可能导致数据丢失）。如果您只希望重分布部分表数据，请提交工单联系火山引擎技术支持人员手动处理。 高级设置：配置重分布的最小只读模式，即设置活跃分区范围，后续重分布数据时，仅活跃分区范围内的数据会被禁止写入，通过仅在重分布部分活跃分区期间禁止新数据写入，来大幅降低表只读的时间。
   扩缩容时间	界面会给出扩缩容/数据重分布的预估时间。您可以根据实际情况，对下游业务发出公告。 注意 实际耗时与节点数、网络速率和磁盘速率都有关系，此处界面上显示的时间仅供预估参考。
   变更费用	为您展示此次变更配置产生的费用变化，参考 变更规格计费说明。

3. 单击页面下方的确认，页面跳转至变配订单确认页面，根据页面提示完成变配付费，集群即开始变配。
   
   当集群在“更改配置中”状态时，后台执行任务流程如下：

   扩容情况	缩容情况
   新增节点时，实际在进行新节点的初始化，并在新节点上新建元数据，此阶段不影响集群读写和性能。 若集群存在 HaUnique 表： 会自动创建虚拟集群，且所有 HaUnique 表自动挂载到虚拟集群，保证扩容前后节点拓扑和数据分布不发生变化。 同时 HaUnique 表对应的 Kafka 同步、离线同步、Flink 同步等同步任务拓扑不变，新节点不会创建 HaUnique 表对应的 HaKafka 和 View 表。	阶段 1：逐一重分布所有表。 此阶段正在重分布的表会进入只读状态，同时集群的计算和 IO 负载会较高，预估读性能会下降且不稳定。如果部分表重分布失败，则不会继续缩容，任务终止。 阶段 2：减少节点。 此阶段不影响集群读写和性能。

4. 上述步骤完成，集群恢复“正在运行”状态。