升级为多可用区部署

步骤一：记录并清理 Kafka/RabbitMQ 引擎表

Kafka/RabbitMQ 引擎表无法通过控制台变配功能直接迁移。变配前，您必须记录这些表的 DDL 语句并将其从集群中删除，以避免干扰变配任务。

1. 登录集群并执行以下语句查询所有 Kafka 和 RabbitMQ 引擎表及其下游依赖。

   /*
   create_table_query：表定义语句
   dependencies_database：依赖该表的数据库
   dependencies_table：依赖该表的表名
   通过 dependencies_database 和 dependencies_table 可以确定依赖 Kafka/RabbitMQ 表的物化视图
   */
   SELECT * FROM system.tables WHERE engine IN ('RabbitMQ', 'Kafka');

2. 查看物化视图定义，检查其目标表是否为隐式表。

   /*
   查看物化视图定义。
   如果物化视图的目标表为隐式表，需特别注意：
   删除物化视图时会同时删除隐式表，导致数据丢失。
   示例：如果 CREATE MATERIALIZED VIEW [db.]table_name [TO[db.]name] 未指定 TO 子句，
   系统会自动创建隐式表，格式可能为 '.inner_id.<TABLE_UUID>' 或 '.inner.<TABLE>'
   */
   SELECT * FROM system.tables WHERE database='<DATABASE>' AND name = '<MATERIALIZED_VIEW_NAME>';

3. 如果物化视图创建时未使用 TO 子句，系统会自动生成以 .inner 或 .inner_id 为前缀的隐式目标表。变配时这些隐式表会迁移到新集群节点，但由于内部命名机制，直接重建原物化视图可能导致命名冲突。因此，您必须先将隐式目标表重命名为常规表名。

   -- 将隐式目标表重命名为常规表名（在所有节点上执行）
   RENAME TABLE <database>.`.inner_id.<uuid>` TO <database>.<new_target_table_name> ON CLUSTER default;

4. 删除物化视图和 Kafka/RabbitMQ 引擎表。

   重要

   必须先删除引用 Kafka/RabbitMQ 表的物化视图，然后再删除 Kafka/RabbitMQ 引擎表。否则变配操作会失败。

   -- 先删除物化视图
   DROP TABLE <database>.<materialized_view_name> ON CLUSTER default;
   
   -- 再删除 Kafka/RabbitMQ 引擎表
   DROP TABLE <database>.<kafka_or_rabbitmq_table_name> ON CLUSTER default;

步骤二：备份非MergeTree类型表的业务数据

1. 登录集群，通过以下语句，查看需要迁移数据的非MergeTree类型的表。

   SELECT
       `database` AS database_name,
       `name` AS table_name,
       `engine`
   FROM `system`.`tables`
   WHERE (`engine` NOT LIKE '%MergeTree%') AND (`engine` != 'Distributed') AND (`engine` != 'MaterializedView') AND (`engine` NOT IN ('Kafka', 'RabbitMQ')) AND (`database` NOT IN ('system', 'INFORMATION_SCHEMA', 'information_schema')) AND (`database` NOT IN (
       SELECT `name`
       FROM `system`.`databases`
       WHERE `engine` IN ('MySQL', 'MaterializedMySQL', 'MaterializeMySQL', 'Lazy', 'PostgreSQL', 'MaterializedPostgreSQL', 'SQLite')
   ))

2. 备份数据。

   您需将以上非MergeTree类型的业务数据进行备份。具体操作，请参见备份数据至OSS。

步骤三：控制台升级操作

1. 登录云数据库ClickHouse控制台，在页面左上角，选择集群所在地域，然后在集群列表页面，单击社区版实例列表页签。

2. 在目标集群所在行的操作列，单击变更配置。

3. 在变更配置弹窗中，选择升级为多可用区部署，单击确定。

4. 在弹出的升级为多可用区部署检测窗口，查看检测状态。

   • 检测成功：单击下一步。

   • 检测失败：根据页面提示进行相应修改，修改完成后单击重试检测。检测成功后，单击下一步。

     在升级为多可用区部署的过程中，检测失败的原因主要有以下几种。

     • 缺失唯一的分布式表：表示本地表没有创建分布式表，需要再创建一个对应的分布式表。

     • 对应的分布式表不唯一：表示本地表有不止一个分布式表，请删除多余的分布式表，仅保留一个即可。

     • Kafka/RabbitMQ引擎表不支持：表示存在Kafka/RabbitMQ引擎表，请删除。

     • 多副本实例存在非Replicated的*MergeTree表：表示数据在多副本之间不一致，扩缩容在迁移数据期间会出现异常。

     • 分布式表和本地表的列不一致：表示需要您修改分布式表和本地表的列一致，否则扩缩容在迁移数据期间会出现异常。

     • 该表在部分节点缺失：您需要在不同分片创建同名的表。针对物化视图inner表，建议重命名inner表，然后重建物化视图，指向重命名后的inner表。具体操作，请参见物化视图inner表在不同分片不一致。

5. 在变配页面，根据您的业务需求，配置部署方案、可用区、专有网交换机以及停写时间。

   说明

   升级为多可用区部署会发生数据迁移，为了保证迁移的成功率，停写时间有以下要求：

   • 建议将停写时间至少设置为30分钟。

   • 升级必须在配置变更创建后的5天内结束，因此，结束停写时间的日期必须小于或等于当前日期+5。

   • 为了降低迁移对您业务的影响，建议您设置的停写时间范围处于您的业务低峰时段。

   如果集群中包含 Kafka/RabbitMQ 引擎表：当变更任务进入数据迁移阶段（表结构迁移完成后），请执行步骤四，在集群上重建 Kafka/RabbitMQ 引擎表，使增量数据恢复流动并同步到新节点。

   在配置的停写窗口到来之前，请执行步骤五，删除集群上的 Kafka/RabbitMQ 引擎表及其下游物化视图，以防止停写期间消息堆积导致数据不一致。

6. 单击立即购买，并根据页面提示完成支付。