---
title: OceanBase 数据库部分租户切主失败问题排查步骤-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于OceanBase 数据库部分租户切主失败问题排查步骤相关的常见问题和使用技巧，帮助您快速解决OceanBase 数据库部分租户切主失败问题排查步骤的难题。
---
切换语言

- 简体中文
- English

划线反馈

# OceanBase 数据库部分租户切主失败问题排查步骤

更新时间：2026-06-12 04:01

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：How-to  

在所有租户整体从主机房切到第二机房的过程中，需要确认所有租户的主副本都已切成功。但在切主的过程中仍然会发现有些租户或者表没有切成功。本文主要描述如何对该问题进行排查，以及可能存在的原因。

## 适用版本

OceanBase 数据库 V2.x 和 V3.x。

## 排查步骤

正常租户切主步骤如下。

1. 切主前检查主副本分布情况。登录sys租户，检查要切主租户的主副本分布情况。

   ```shell
   obclient [oceanbase]> SELECT count(1),svr_ip FROM __all_virtual_meta_table WHERE tenant_id=1002 and role=1 group by svr_ip order by 1 desc;

   ```
 2. 租户切主命令，租户名为：odc_tenant。

   ```shell
   obclient [oceanbase]> alter tenant odc_tenant primary_zone 'zone2';

   ```
 3. 查看副本迁移进度。

   ```
 4. 确认主副本是否迁移完成。和步骤 1 里的结果进行比对。

   ```
 5. 确认租户 Primary Zone。

   ```shell
   obclient [oceanbase]> select * from __all_tenant where tenant_name='odc_tenant';

   ```

在对所有租户的切主过程中，如果存在主切失败的情况，主要的原因有以下几个。

- 指定了表级别的 Primary Zone ，使用以下命令排查。

  ```shell
  obclient> select primary_zone,tenant_id,table_id from __all_virtual_table where where primary_zone !='';

  ```

  对于查出来的表，执行以下 SQL 来重置 Primary Zone。

  ```shell
  obclient> alter table table_name set PRIMARY_ZONE=default;

  ```
 - 指定了数据库级级别的 primary_zone，使用以下命令排查。

  ```shell
  obclient> select tenant_id,dataase_id,database_name,primary_zone from __all_virtual_database where primary_zone is null ;

  ```

  同样对于查出来的库，执行以下 SQL 来重置 Primary Zone。

  ```shell
  obclient> alter database set primary_zone=default;

  ```

Previous

[如何诊断 OceanBase 数据库切主原因](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000207768)

Next

[CLOG 写盘 HANG 导致切主问题](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000284437) ![有帮助](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) 咨询热线