更改复制表属性

OceanBase 数据库中通过 DUPLICATE_SCOPE 参数来指定复制表的属性。表创建成功后，可以通过修改 DUPLICATE_SCOPE 参数的值来实现复制表与普通表之间的相互转换。

使用限制及注意事项

• 在进行复制表的转换时，如果当前租户有扩缩容、Primary Zone 变更以及 Locality 变更等行为触发了负载均衡任务，则复制表属性的转换任务需要等待当前均衡任务完成。

  注意

  复制表转换过程是异步的，在手动修改 DUPLICATE_SCOPE 后，需要等待后台分区均衡任务完成才可以实际当做目标属性的表使用。更多有关分区均衡的信息，请参见 租户内均衡。

• 由于复制表与表组互斥，在将普通表转换为复制表时，如果待转换的普通表属于某个表组，则该普通表无法转换为复制表。

• 复制表的转换依赖租户的负载均衡及 Transfer 功能，当租户级配置项 enable_rebalance、enable_transfer 以及 enable_rereplication 中任意一个配置项的值为 false 即关闭状态时，均无法进行复制表的转换操作。如果修改配置项 enable_rebalance、enable_transfer 的值为 false 时，有正在执行的复制表转换任务，则对应的复制表转换任务会被取消。

前提条件

在进行复制表的转换操作前，请确认以下配置项的值已设置为 True：

• enable_rebalance

  租户级配置项 enable_rebalance 在系统租户下用于控制是否进行租户间的负载均衡；在用户租户下用于控制是否进行租户内均衡。默认值为 True。有关配置项 enable_rebalance 的详细说明及设置，请参见 enable_rebalance。

• enable_transfer

  租户级配置项 enable_transfer 用于控制是否在租户下进行 Transfer，默认值为 True。有关配置项 enable_transfer 的详细说明及设置，请参见 enable_transfer。

• enable_rereplication

  集群级配置项 enable_rereplication 是日志流副本自动迁移复制的总开关。默认值为 True。有关配置项 enable_rereplication 的详细说明及设置，请参见 enable_rereplication。

更改复制表属性语法

更改复制表属性的 SQL 语句如下：

ALTER TABLE table_name DUPLICATE_SCOPE= 'none | cluster';

语句中：

• none：表示将当前表转换为普通表。
• cluster：表示将当前表转换为复制表。

示例

下面的命令展示了如何将一个复制表转换为普通表。

1. 创建复制表 tbl1。

   obclient [test]> CREATE TABLE tbl1 (c1 int,c2 int) DUPLICATE_SCOPE= 'cluster';
   

2. 将该复制表转换为普通表。

   ALTER TABLE tbl1 DUPLICATE_SCOPE= 'none';
   

   注意

   上面 SQL 语句在修改表属性后会立即返回成功，实际复制表转换动作由后台线程异步执行。

3. 查看表的复制表属性。

   通过视图 oceanbase.DBA_OB_TABLE_LOCATIONS 可以查看表当前的复制表属性及所在的日志流 ID。其中 DUPLICATE_SCOPE 列为 CLUSTER 则表示是复制表，为 NONE 则表示是普通表。

   SELECT database_name, table_name, table_id, tablet_id, ls_id, role, duplicate_scope
   FROM oceanbase.DBA_OB_TABLE_LOCATIONS
   WHERE table_name = 'tbl1';
   

   返回结果如下：

   +---------------+------------+----------+-----------+-------+--------+-----------------+
   | database_name | table_name | table_id | tablet_id | ls_id | role   | duplicate_scope |
   +---------------+------------+----------+-----------+-------+--------+-----------------+
   | test          | tbl1       |   500011 |    200002 |  1002 | LEADER | NONE            |
   +---------------+------------+----------+-----------+-------+--------+-----------------+
   1 row in set
   

   说明

   可以根据以下步骤查看复制表转换后分区副本的分布是否符合目标属性。

4. 查看复制表转换进度。

   1. 查看日志流的属性。

      租户下所有复制表都要放到专门承载复制表的特殊日志流（广播日志流）上。过视图 oceanbase.DBA_OB_LS 可以查看日志流的属性。其中 FLAG 列包含 DUPLICATE 表示为广播日志流。FLAG 为空或者不包含 DUPLICATE 则表示为普通日志流。

      SELECT * FROM oceanbase.DBA_OB_LS WHERE LS_ID = 1002;
      

      返回结果如下：

      +-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
      | LS_ID | STATUS | PRIMARY_ZONE | UNIT_GROUP_ID | LS_GROUP_ID | CREATE_SCN          | DROP_SCN | SYNC_SCN            | READABLE_SCN        | FLAG      |
      +-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
      |  1002 | NORMAL | zone1        |             0 |           0 | 1713164377091593001 |     NULL | 1713171198496433000 | 1713171198496433000 | DUPLICATE |
      +-------+--------+--------------+---------------+-------------+---------------------+----------+---------------------+---------------------+-----------+
      1 row in set
      

   2. 判断是否需要生成复制表转换任务。

      复制表转换任务通过后台负载均衡及 Transfer 模块生成。可以通过以下语句，快速判断是否需要生成复制表转换任务。其中 DUPLICATE_SCOPE 是表的属性，FLAG 是当前表的 tablet 所属 LS 的属性。FLAG 中包含 DUPLICATE 则代表广播日志流。

      SELECT A.duplicate_scope, B.flag
      FROM oceanbase.DBA_OB_TABLE_LOCATIONS AS A JOIN oceanbase.DBA_OB_LS AS B ON A.ls_id = B.ls_id
      WHERE A.table_name = 'tbl1'
      AND A.role = 'LEADER';
      

      返回结果如下：

      +-----------------+-----------+
      | duplicate_scope | flag      |
      +-----------------+-----------+
      | NONE            | DUPLICATE |
      +-----------------+-----------+
      1 row in set
      

      返回信息解释如下：

      • DUPLICATE_SCOPE 为 NONE，FLAG 包含 DUPLICATE：非复制表在广播日志流上，需要生成复制表转普通表的任务，将非复制表从广播日志流 Transfer 到普通日志流。
      • DUPLICATE_SCOPE 为 NONE，FLAG 不包含 DUPLICATE：复制表在普通日志流上，需要生成普通表转复制表任务，将复制表从普通日志流 Transfer 到广播日志流上。

   3. 立即生成转换任务。

      可以通过临时调小配置项 partition_balance_schedule_interval ，立即生成转换任务。

      ALTER SYSTEM SET partition_balance_schedule_interval = '30s';
      

   4. 查看复制表转换任务。

      复制表转换生成的任务可以通过相关视图 DBA/CDB_OB_BALANCE_JOB_HISTORY 和 DBA/CDB_OB_BALANCE_JOBS 进行查看。

      1. 查看历史转换任务执行情况。

         如果没有历史记录，则可能正在执行或还未生成任务。

         SELECT * FROM oceanbase.DBA_OB_BALANCE_JOB_HISTORY;
         

         返回结果如下：

         +--------+----------------------------+----------------------------+-------------------+-------------------+-----------------+-------------------------+-----------+---------+
         | JOB_ID | CREATE_TIME                | FINISH_TIME                | BALANCE_STRATEGY  | JOB_TYPE          | TARGET_UNIT_NUM | TARGET_PRIMARY_ZONE_NUM | STATUS    | COMMENT |
         +--------+----------------------------+----------------------------+-------------------+-------------------+-----------------+-------------------------+-----------+---------+
         | 777854 | 2024-04-15 16:54:29.220400 | 2024-04-15 16:54:39.231516 | partition balance | PARTITION_BALANCE |               1 |                       1 | COMPLETED | NULL    |
         +--------+----------------------------+----------------------------+-------------------+-------------------+-----------------+-------------------------+-----------+---------+
         1 row in set
         

      2. 查看当前均衡任务执行情况。

         SELECT * FROM oceanbase.DBA_OB_BALANCE_JOBS;
         

      3. 查看转换任务对应的子任务（包含分区列表）

         将上述任务对应 job_id 填入下面 SQL 语句中：

         SELECT * FROM oceanbase.DBA_OB_BALANCE_TASKS WHERE JOB_ID = xxxx;
         

         SELECT * FROM oceanbase.DBA_OB_BALANCE_TASK_HISTORY WHERE JOB_ID = xxxx;
         

相关文档

• 创建表
• 更改表