---
title: "ACTIVATE STANDBY - OceanBase 数据库 V4.4.2 | OceanBase 文档中心"
description: ACTIVATE STANDBY 物理恢复完成后或者物理备库场景下准备备切主时，可以使用 ALTER SYSTEM ACTIVATE STANDBY 命令将备租户激活为主租户。 ALTER SYSTEM ACTIVATE STANDBY 命令执行成功后，原备租户的租户角色由 STANDBY 变成 PRIMARY ，有…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.4.2 LTS

# ACTIVATE STANDBY

更新时间：2026-07-01 10:36:40

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.4.2/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/100.activate.md)  

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

`ALTER SYSTEM ACTIVATE STANDBY` 命令执行成功后，原备租户的租户角色由 `STANDBY` 变成 `PRIMARY`，有关租户角色的相关说明，请参见 [租户角色概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005283283)。

## 使用限制及注意事项

- 执行该命令要求备租户所有日志流的副本均在线，如果备租户有日志流的副本不在线，则需要等待对应的副本永久下线后再执行。
 - 该命令每次只能将一个备租户激活为主租户，如果需要激活多个租户，需要重复执行该命令。

## 权限要求

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

- MySQL 模式的默认管理员用户为 `root` 用户。
 - Oracle 模式的默认管理员用户为 `SYS` 用户。

## 语法

```sql
ALTER SYSTEM ACTIVATE STANDBY
    [TENANT tenant_name]
    [VERIFY [NOWAIT]];

```

## 参数说明

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

## 示例

- 物理备库场景下，备租户所在集群的系统租户将备租户 `tenant1` 激活为主租户。或者，物理备份恢复场景下，备租户所在集群的系统租户将新恢复出来的备租户 `tenant1` 激活为主租户提供服务。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM ACTIVATE STANDBY TENANT tenant1;

  ```
 - 物理备库场景下，备租户将本租户激活为主租户。或者，物理备份恢复场景下，备租户将本租户激活为主租户提供服务。

  ```sql
  obclient [SYS]> ALTER SYSTEM ACTIVATE STANDBY;

  ```
 - 备租户下，执行 Failover 进行备切主前，进行预检查确认备租户是否具备执行 `ACTIVATE STANDBY` 命令所必须的前提条件，并指定发现有条件不符合时，立即返回错误。

  ```shell
  obclient> ALTER SYSTEM ACTIVATE STANDBY VERIFY NOWAIT;

  ```

## 相关文档

- [Failover](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005283284)
 - [备租户转为主租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005282827)

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线