---
title: 黑屏 Failover 过程及 Verify 预检查项拆分-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 黑屏 Failover 过程及 Verify 预检查项拆分相关的常见问题和使用技巧，帮助您快速解决 黑屏 Failover 过程及 Verify 预检查项拆分的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 黑屏 Failover 过程及 Verify 预检查项拆分

更新时间：2026-05-09 07:56

适用版本： V4.0.x、V4.1.x、V4.2.x、V4.3.x、V4.4.x 内容类型：TechNote  

**适用场景：** OCP 不可用，黑屏 Failover 故障应急场景，客户端登录备租户所在集群，检查备租户是否具备 Failover 条件、查询 Failover 目标 SCN 快照位点，及完整 Failover 过程指令。

## 详细说明

1. 执行 Failover 切换预检查。

   ```sql
   -- 集群 sys 租户：
   ALTER SYSTEM ACTIVATE STANDBY TENANT = $tenant_name VERIFY;
   -- 或者业务租户：
   ALTER SYSTEM ACTIVATE STANDBY VERIFY;
   -- 结果样例：
   Query OK, 0 rows affected (3.172 sec)   "Query OK" --> 则验证通过

   ```
 2. 查询备租户的 Failover SCN。

   ```sql
   -- 集群 sys 租户
   select tenant_id,tenant_name,tenant_role,scn_to_timestamp(sync_scn) failover_target_scn from dba_ob_tenants where tenant_name=$tenant_name;
   +-----------+-------------+-------------+----------------------------+
   | tenant_id | tenant_name | tenant_role | failover_target_scn        |
   +-----------+-------------+-------------+----------------------------+
   |      1026 | $tenant_name| STANDBY     | 2025-12-09 15:44:19.582936 |
   +-----------+-------------+-------------+----------------------------+

   ```
 3. 执行 Failover 切换。

   ```sql
   -- 集群 sys 租户：
   ALTER SYSTEM ACTIVATE STANDBY TENANT = $tenant_name;
   -- 或者业务租户：
   ALTER SYSTEM ACTIVATE STANDBY;

   ```
 4. 确认 Failover 结果。

   ```sql
   -- 集群 sys 租户
   SELECT TENANT_NAME, TENANT_TYPE, TENANT_ROLE, SWITCHOVER_STATUS FROM oceanbase.DBA_OB_TENANTS where tenant_name = $tenant_name;
   +-----------------+-------------+-------------+-------------------+
   | TENANT_NAME     | TENANT_TYPE | TENANT_ROLE | SWITCHOVER_STATUS |
   +-----------------+-------------+-------------+-------------------+
   | $tenant_name    | USER        | PRIMARY     | NORMAL            |
   +-----------------+-------------+-------------+-------------------+
   备租户的 TENANT_ROLE 变为 PRIMARY，且 SWITCHOVER_STATUS 为 NORMAL，则表示备租户切主成功

   ```

### Failover 切换预检查项

1. 租户状态检查。

   ```sql
   SELECT
    TENANT_ID,
    TENANT_NAME,
    TENANT_ROLE,
    STATUS,
    SWITCHOVER_STATUS,
    RECOVERY_UNTIL_SCN,
    scn_to_timestamp(SYNC_SCN) failover_target_scn FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = $tenant_name OR TENANT_ID = $tenant_id;

   +-----------+-------------+-------------+--------+-------------------+---------------------+----------------------------+
   | TENANT_ID | TENANT_NAME | TENANT_ROLE | STATUS | SWITCHOVER_STATUS | RECOVERY_UNTIL_SCN  | failover_target_scn        |
   +-----------+-------------+-------------+--------+-------------------+---------------------+----------------------------+
   |      1026 | $tenant_name| STANDBY     | NORMAL | NORMAL            | 4611686018427387903 | 2025-12-09 15:50:57.752932 |
   +-----------+-------------+-------------+--------+-------------------+---------------------+----------------------------+

   ```

   #### 说明

      1. 租户角色必须是 STANDBY（不能是 PRIMARY）。
      2. 租户状态必须为 NORMAL。
      3. 租户 `SWITCHOVER_STATUS` 必须是 NORMAL。
      4. `RECOVERY_UNTIL_SCN` 必须有效且不为最小值。
 2. 服务器在线状态检查。

   ```sql
   select svr_ip,zone,status,stop_time,last_offline_time from __all_server order by zone;
   +---------------+-------+--------+-----------+-------------------+
   | svr_ip        | zone  | status | stop_time | last_offline_time |
   +---------------+-------+--------+-----------+-------------------+
   | xxx.xx.xx.101 | zone1 | ACTIVE |         0 |                 0 |
   | xxx.xx.xx.102 | zone2 | ACTIVE |         0 |                 0 |
   | xxx.xx.xx.103 | zone3 | ACTIVE |         0 |                 0 |
   +---------------+-------+--------+-----------+-------------------+

   ```

   #### 说明

      1. 不能有临时离线服务器（temporary offline servers）。
      2. 永久离线服务器上不能存在该租户的 LS 副本。
 3. 备租户所有日志流副本在线。

   ```sql
   select LS_ID,STATUS,PRIMARY_ZONE,scn_to_timestamp(sync_scn) SYNC_SCN from cdb_ob_ls where tenant_id=1026;
   +-------+--------+-------------------+----------------------------+
   | LS_ID | STATUS | PRIMARY_ZONE      | SYNC_SCN                   |
   +-------+--------+-------------------+----------------------------+
   |     1 | NORMAL | zone1;zone2;zone3 | 2025-12-09 16:03:16.835525 |
   |  1001 | NORMAL | zone1;zone2;zone3 | 2025-12-09 16:03:18.432208 |
   +-------+--------+-------------------+----------------------------+

   ```

## 适用版本

OceanBase 数据库 V4.x 版本。

Previous

[仲裁相关问题排查](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000871654)

Next

[带有备租户的集群在升级混跑阶段备租户回放位点卡住](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002119111) ![有帮助](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) 咨询热线