Failover

当主租户不可用时，可以将备租户切换为主租户继续提供服务。

使用限制

• 执行 Failover 时，要求备租户所有日志流的副本均在线，否则需要等待对应的副本永久下线。

  备租户或备租户所在集群的sys 租户可以分别通过 DBA_OB_LS 视图或 CDB_OB_LS 视图查询所有日志流副本是否在线，有关日志流副本的详细说明信息，请参见 副本介绍。

• 执行 Failover 时，不会检查对应主租户的状态，因此除主租户故障的容灾需求外，Failover 操作也可以用于独立的一个主租户在某一个时间点的快照并用于后续业务验证的需求场景。

• 不允许在通过服务名建立的 Session 中执行 Failover 命令。有关服务的相关操作及说明，参见 创建服务。

  注意

  执行 Failover 时，如果待执行 Failover 命令的租户下有服务名，则系统会自动删除该租户的服务名。

背景信息

Failover 操作只会对日志文件做修改，不会对数据文件做修改。

由于 OceanBase 数据库的每个租户均有多个日志流，而 Failover 操作需要在操作执行完成后达到数据一致的状态，故系统会选择所有日志流的同步位点中 SCN 最小的值作为 Failover 的执行位点。执行Failover 操作后，租户下的所有日志流都会统一回退到该位点。

操作步骤

1. 使用管理员用户登录备租户或备租户所在集群的 sys 租户。

2. 执行 ACTIVATE STANDBY VERIFY 命令，验证 ACTIVATE STANDBY 命令是否可以执行成功。

   • 备所在集群的 sys 租户执行 ACTIVATE STANDBY VERIFY 命令

     ALTER SYSTEM ACTIVATE STANDBY TENANT [=] tenant_name VERIFY;
     

     示例：

     ALTER SYSTEM ACTIVATE STANDBY TENANT = mysql VERIFY;
     

   • 备租户执行 ACTIVATE STANDBY VERIFY 命令

     ALTER SYSTEM ACTIVATE STANDBY VERIFY;
     

     命令执行后，如果返回 OK，则表示验证通过，可以执行下一步。

     如果出现报错，请根据提示的文本信息参考文档 Switchover 或 Failover 相关问题 进行处理后，再重新执行本命令。

3. 验证通过后，执行 ACTIVATE STANDBY 命令，将备租户切换为主租户。

   • 备租户所在集群的 sys 租户将备租户切换为主租户

     ALTER SYSTEM ACTIVATE STANDBY TENANT = tenant_name;
     

   • 备租户将本租户切换为主租户

     ALTER SYSTEM ACTIVATE STANDBY;
     

4. 查询 DBA_OB_TENANTS 视图，确认备租户是否已切换为主租户。

   • 备租户所在集群的 sys 租户查询视图

     obclient [oceanbase]> SELECT TENANT_NAME, TENANT_TYPE, TENANT_ROLE, SWITCHOVER_STATUS FROM oceanbase.DBA_OB_TENANTS;
     

   • 备租户查询视图

     MySQL 模式：

     obclient [oceanbase]> SELECT TENANT_NAME, TENANT_TYPE, TENANT_ROLE, SWITCHOVER_STATUS FROM oceanbase.DBA_OB_TENANTS;
     

     Oracle 模式：

     obclient [SYS]> SELECT TENANT_NAME, TENANT_TYPE, TENANT_ROLE, SWITCHOVER_STATUS FROM SYS.DBA_OB_TENANTS;
     

   查询结果的示例如下：

   +-----------------+-------------+-------------+-------------------+
   | TENANT_NAME     | TENANT_TYPE | TENANT_ROLE | SWITCHOVER_STATUS |
   +-----------------+-------------+-------------+-------------------+
   | standby_tenant  | USER        | PRIMARY     | NORMAL            |
   +-----------------+-------------+-------------+-------------------+
   1 row in set
   

   根据查询结果，备租户的 TENANT_ROLE 变为 PRIMARY，且 SWITCHOVER_STATUS 为 NORMAL，则表示备租户切主成功。

Failover 后的注意事项

• 租户在执行 Failover 命令切换为主租户的过程中，如果该租户有服务名，则系统会自动删除该租户的服务名。但是，系统不会删除原主租户的服务名。

  例如，服务名 service1 下有一个主租户 tenantA 和其对应的备租户 tenantB，在租户 tenantB 上执行 Failover 命令切换为主租户时，由于脱离了原来的主备关系，tenantB 的服务名 service1 会被系统删除，而 tenantA 的服务名 service1 会保留。

• 由于 Failover 操作会将所有日志流已同步的数据恢复到一致性位点，保证该位点之前的所有日志流的数据是完整的。故执行 Failover 操作后：

  • 不支持原主租户降备后接入成为新主租户的备租户。

  • 对于第三方备租户，取决于备租户同步的日志，如果同步的日志超过一致性位点，则不支持接入作为新主租户的备租户。为了便于管理，不建议第三方备租户接入作为新主租户的备租户。