---
title: github-fill
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.5.0

# ACTIVATE STANDBY

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

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/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-1000000004476428)。

## 使用限制及注意事项

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

## 权限要求

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

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

## 语法

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

```

## 参数说明

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

## 示例

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

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

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

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

  ```

## 相关文档

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

 上一篇 下一篇 ![有帮助](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) 咨询热线