---
title: "删除租户 - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: 删除租户 OceanBase 数据库支持通过 DROP TENANT 语句删除租户。 删除租户后，租户下的数据库和表也同时被删除。但是租户使用的资源池不会被删除。资源池可以继续给其他租户使用。 当系统租户开启回收站功能时， DROP TENANT 操作表示删除的租户会进入回收站。对于回收站中的租户，后续系统租户可以通…
---
切换语言

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

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

# 删除租户

更新时间：2026-04-15 17:16:58

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/600.manage/200.tenant-management/600.common-tenant-operations/1200.delete-tenant.md)  

OceanBase 数据库支持通过 `DROP TENANT` 语句删除租户。

删除租户后，租户下的数据库和表也同时被删除。但是租户使用的资源池不会被删除。资源池可以继续给其他租户使用。

- 当系统租户开启回收站功能时，`DROP TENANT` 操作表示删除的租户会进入回收站。对于回收站中的租户，后续系统租户可以通过租户级回收站功能进一步删除或恢复该租户，回收站相关操作参见 [回收站概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499781)。
 - 当系统租户关闭回收站功能时，`DROP TENANT` 操作会直接删除租户，租户下的数据库和表也同时被删除。

## 操作步骤

1. 使用 `root` 用户登录到集群的 `sys` 租户。

   ```shell
   obclient -h172.30.xx.xx -P2883 -uroot@sys#cluster -p**** -A

   ```
 2. 进入 `oceanbase` 数据库。

   ```shell
   obclient [(none)]> USE oceanbase;

   ```
 3. 通过 `DBA_OB_TENANTS` 视图，查看租户信息。根据租户的 ID、创建时间、资源分配等基本信息，确认是需要执行删除的租户。

   以查询租户 `mq_t1` 的信息为例：

   ```shell
   obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS WHERE TENANT_NAME = 'mq_t1'\G

   ```

   返回结果如下：

   ```shell
   *************************** 1. row ***************************
                    TENANT_ID: 1036
                  TENANT_NAME: mq_t
                  TENANT_TYPE: USER
                  CREATE_TIME: 2025-06-20 09:50:54.113568
                  MODIFY_TIME: 2025-06-20 09:52:55.241069
                 PRIMARY_ZONE: zone1;zone2
                     LOCALITY: FULL{1}@zone1, FULL{1}@zone2
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: MYSQL
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: 1684396167132057328
               REPLAYABLE_SCN: 1684396167132057328
                 READABLE_SCN: 1684396167051160964
           RECOVERY_UNTIL_SCN: 4611686018427387903
                     LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: DISABLED
                     UNIT_NUM: 1
           ZONE_UNIT_NUM_LIST: zone1:1,zone2:1
                   COMPATIBLE: 4.2.5.5
                    MAX_LS_ID: 1002
            FLASHBACK_LOG_SCN: NULL
   1 row in set

   ```

   `DBA_OB_TENANTS` 视图的详细说明，参见 [DBA_OB_TENANTS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001501698)。
 4. （可选）为防止恶意或误操作导致的数据不可恢复性丢失，OceanBase 数据库提供了租户级的回收站功能，从而支持租户级的数据的快速恢复功能。回收站默认关闭，您可以根据需要，开启租户级的回收站功能。有关回收站的详细说明，请参见 [回收站](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499781)。

   开启租户级的回收站后，在系统租户下使用 `SHOW RECYCLEBIN` 语句，可以查看当前系统租户 RECYCLEBIN 中的回收站对象。示例如下：

   ```shell
   obclient [oceanbase]> SHOW RECYCLEBIN;
   +--------------------------------+----------------+-----------+----------------------------+
   | OBJECT_NAME                    | ORIGINAL_NAME  | TYPE      | CREATETIME                 |
   +--------------------------------+----------------+-----------+----------------------------+
   | __recycle_$_1_1600136460199936 | obdemo_table    | TABLE    | 2020-09-15 10:21:00.207886 |
   | __recycle_$_1_1600136479664128 | obdemo_database | DATABASE | 2020-09-15 10:21:19.664534 |
   | __recycle_$_1_1600135793000960 | omysql          | TENANT   | 2020-09-15 10:23:25.773877 |
   +--------------------------------+----------------+-----------+----------------------------+
   3 rows in set

   ```

   参数说明：

      - `OBJECT_NAME`：表示该对象在回收站中的名称。
      - `ORIGINAL_NAME`：表示原对象名。
      - `TYPE`：表示回收站对象所属的类型。当前主要支持 INDEX、TABLE、DATABASE 和 TENANT 等四种类型。本示例中，omysql 即为一个租户类型的回收站对象。
      - `CREATETIME`：表示该对象进入回收站的时间。
 5. 通过 `DROP TENANT` 语句，删除租户。

   ```sql
   obclient> DROP TENANT mq_t1;

   ```

   `DROP TENANT` 语句的详细说明，参见 [DROP TENANT](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001501962)。
 6. 查看 `DBA_OB_TENANTS` 视图，确认租户已经删除成功。

   ```shell
   obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS WHERE TENANT_NAME = 'mq_t1';
   Empty set

   ```
 7. （可选）在操作步骤 4 中如果开启了回收站功能，则可以通过 `SHOW RECYCLEBIN` 语句查看回收站中的信息。

   ```shell
   obclient [oceanbase]> SHOW RECYCLEBIN;
   +-------------------------------------+---------------+--------+----------------------------+
   | OBJECT_NAME                         | ORIGINAL_NAME | TYPE   | CREATETIME                 |
   +-------------------------------------+---------------+--------+----------------------------+
   | __recycle_$_100017_1673367572701376 | mq_t1         | TENANT | 2025-06-20 09:50:54.113568 |
   +-------------------------------------+---------------+--------+----------------------------+
   1 row in set

   ```

   回收站相关参数的详细说明，参见 [recyclebin](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001502584)。

## 相关文档

删除后若需要恢复租户，相关信息参见：

- [恢复租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499851)
 - [回收站](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499781)
 - [恢复回收站对象](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001499783)

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