MODIFY LS

描述

该语句用于变更日志流，包括修改日志流的 UNIT_GROUP 和日志流的 PRIMARY_ZONE。

使用限制及注意事项

• 对于 V4.2.1 版本，该语句需要在 V4.2.1 BP11 及以上版本上执行。
• 变更日志流时，待变更的日志流必须存在且状态必须为 NORMAL。
• 变更日志流时，待变更日志流的租户其租户状态必须为 NORMAL。
• 在主租户上修改日志流的 UNIT_GROUP 时，要求租户的所有日志流当前没有负载均衡任务。
• 不建议在备租户上修改日志流的 UNIT_GROUP 属性。由于备租户会自动调整日志流的 UNIT_GROUP 属性，手动修改备租户日志流的 UNIT_GROUP 属性可能不生效。
• 修改日志流的 UNIT_GROUP 时，要求目标 UNIT_GROUP 的状态必须为 ACTIVE。
• 修改日志流的 PRIMARY_ZONE 时，需要保证修改后的 Zone 在租户的 ZONE_LIST 中。对于日志流而言，设置 PRIMARY_ZONE 与租户的 PRIMARY_ZONE 略有不同，日志流仅允许设置一个 Zone，例如 z1 或z2，不能像租户一样设置 z1,z2、z1; z2 或 RANDOM。
• 变更日志流时，要求租户级配置项 enable_rebalance 为关闭状态，即值为 False。当 enable_rebalance 为开启状态时，租户的负载均衡模块可能会自动调整日志流的 PRIMARY_ZONE 和 UNIT_GROUP 属性。
• 只有广播日志流和系统日志流（1 号日志流）才支持指定 UNIT_GROUP 为 0。

权限要求

执行该语句的用户需要拥有 ALTER SYSTEM 权限。有关 OceanBase 数据库权限的详细介绍，请参见 MySQL 模式下的权限分类 和 Oracle 模式下的权限分类。

语法

ALTER SYSTEM MODIFY LS
    LS [=] ls_id
    [UNIT_GROUP [=] unit_group_id]
    [,PRIMARY_ZONE [=] 'zone_name'] 
    [TENANT [=] 'tenant_name'];

参数说明

示例

• 仅修改日志流的 UNIT_GROUP

  修改租户 obtenant 的 1002 号日志流的位置到 1002 号的 UNIT_GROUP。

  • 系统租户修改用户租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 UNIT_GROUP 1002 TENANT = obtenant;
    

  • 用户租户修改本租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 UNIT_GROUP 1002;
    

• 仅修改日志流的 PRIMARY_ZONE

  修改租户 obtenant 的 1002 号日志流 Leader 的第一优先级到 z1。

  • 系统租户修改用户租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 PRIMARY_ZONE 'z1' TENANT = obtenant;
    

  • 用户租户修改本租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 PRIMARY_ZONE 'z1';
    

• 同时修改日志流的 UNIT_GROUP 和 PRIMARY_ZONE

  修改租户 obtenant 的 1002 日志流的位置到 1002 的 UNIT_GROUP，并修改日志流 Leader 的第一优先级到 z1。

  • 系统租户修改用户租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 UNIT_GROUP 1002, PRIMARY_ZONE 'z1' TENANT = obtenant;
    

  • 用户租户修改本租户的日志流

    obclient> ALTER SYSTEM MODIFY LS 1002 UNIT_GROUP 1002, PRIMARY_ZONE 'z1';
    

相关文档

变更日志流