ACTIVATE STANDBY

更新时间：2026-04-07 08:46:52

物理恢复完成后或者物理备库场景下准备备切主时，可以使用 ALTER SYSTEM ACTIVATE STANDBY 命令将备租户激活为主租户。

ALTER SYSTEM ACTIVATE STANDBY 命令执行成功后，原备租户的租户角色由 STANDBY 变成 PRIMARY，有关租户角色的相关说明，请参见租户角色概述。

使用限制及注意事项

需要由 sys 租户的 root 用户（root@sys）或各租户的管理员用户执行。其中：

ALTER SYSTEM ACTIVATE STANDBY
    [TENANT tenant_name]
    [VERIFY];

参数项描述

tenant_name

参数项	描述
tenant_name	指定待激活为主租户的备租户名。注意仅系统租户在执行此命令时需要通过 `TENANT tenant_name`参数指定待操作的租户；普通租户只能对本租户执行此命令，故不需要指定该参数。
VERIFY	可选项。当使用此参数时，它的作用是进行预先检验，以确认执行 `ACTIVATE STANDBY` 命令所必须的前提条件是否已经具备。注意主备租户角色转换执行中存在一定失败风险。`VERIFY` 命令只是进行前期验证，评估满足角色转换的前提条件，有助于减少该操作失败的可能性，并不实际执行 `ACTIVATE STANDBY` 操作。即使 `VERIFY` 命令运行成功，也不能保证随后的 `ACTIVATE STANDBY` 操作一定会成功。

指定待激活为主租户的备租户名。

仅系统租户在执行此命令时需要通过 TENANT tenant_name参数指定待操作的租户；普通租户只能对本租户执行此命令，故不需要指定该参数。

VERIFY

可选项。当使用此参数时，它的作用是进行预先检验，以确认执行 ACTIVATE STANDBY 命令所必须的前提条件是否已经具备。

主备租户角色转换执行中存在一定失败风险。VERIFY 命令只是进行前期验证，评估满足角色转换的前提条件，有助于减少该操作失败的可能性，并不实际执行 ACTIVATE STANDBY 操作。
即使 VERIFY 命令运行成功，也不能保证随后的 ACTIVATE STANDBY 操作一定会成功。

物理备库场景下，备租户所在集群的系统租户将备租户 tenant1 激活为主租户。或者，物理备份恢复场景下，备租户所在集群的系统租户将新恢复出来的备租户 tenant1 激活为主租户提供服务。
```
obclient [oceanbase]> ALTER SYSTEM ACTIVATE STANDBY TENANT tenant1;
```
物理备库场景下，备租户将本租户激活为主租户。或者，物理备份恢复场景下，备租户将本租户激活为主租户提供服务。
```
obclient [SYS]> ALTER SYSTEM ACTIVATE STANDBY;
```