Failover

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

操作步骤

1. 备租户或备租户所在集群的 sys 租户的租户管理员登录到数据库。

2. 执行 Failover 命令，将备租户切换为主租户。

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

     ALTER SYSTEM ACTIVATE STANDBY TENANT = tenant_name;
     

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

     ALTER SYSTEM ACTIVATE STANDBY;
     

3. 检查备租户是否已切换为主租户。

   示例如下：

   SELECT TENANT_ID, TENANT_NAME,TENANT_TYPE,TENANT_ROLE,SWITCHOVER_STATUS 
   FROM oceanbase.DBA_OB_TENANTS 
   WHERE TENANT_NAME='oracle_standby';
   

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

   有关 DBA_OB_TENANTS 视图的更多说明，请参见 oceanbase.DBA_OB_TENANTS（MySQL 模式） 和 DBA_OB_TENANTS（Oracle 模式）。

Failover 后的注意事项

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

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

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