---
title: "删除租户 | OceanBase 文档中心"
description: 删除租户 您可以通过 SQL 语句删除租户。 通过 SQL 语句删除租户 删除租户后，租户下的数据库和表也同时被删除。但是租户使用的资源配置不会被删除。资源配置可以继续给其他租户使用。 注意 只有系统管理员（ sys 租户的 root 用户）才能执行 DROP TENANT 命令。 删除租户的语法 SQL 语句如下：…
---
切换语言

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

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

# 删除租户

更新时间：2026-06-09 08:08:18

您可以通过 SQL 语句删除租户。

## 通过 SQL 语句删除租户

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

> **注意**
>
>  
>
> 只有系统管理员（`sys` 租户的 `root` 用户）才能执行 `DROP TENANT` 命令。

删除租户的语法 SQL 语句如下：

```sql
obclient> DROP TENANT tenant_name [FORCE]

```

或者

```sql
obclient> DROP TENANT tenant_name PURGE;

```

其中：

- 对于 `DROP TENANT` 操作：

     - 当系统租户开启回收站功能时，`DROP TENANT` 操作表示删除的租户会进入回收站。对于回收站中的租户，后续系统租户可以通过租户级回收站功能进一步删除或恢复该租户，租户级回收站相关操作请参见 [租户回收站](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000881505)。
     - 当系统租户关闭回收站功能时，`DROP TENANT` 操作表示延迟删除租户，后台线程会进行 GC（Garbage Collection）动作，租户的信息仍然可以通过内部表查询。租户具体延迟删除的时间由配置项 `schema_history_expire_time` 控制，默认为 7 天，表示执行 `DROP TENANT` 7 天后，租户会被删除，租户下的数据库和表也同时被删除。

      `schema_history_expire_time` 配置项更多信息请参见 [schema_history_expire_time](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000884928)。
 - `DROP TENANT PURGE` 操作表示仅延迟删除租户，且无论系统租户是否开启回收站功能，删除的租户均不进入回收站。
 - `FORCE` 参数表示无论系统租户是否开启回收站功能，均可以立刻删除租户。

示例：

- 系统租户开启回收站功能后，删除租户 `t1`，删除的租户可进入回收站。系统租户关闭回收站功能时，删除租户 `t1`，租户被延迟删除。

  ```sql
  obclient> DROP TENANT t1;

  ```
 - 延迟删除租户 `t1`，删除的租户不进入回收站。

  ```sql
  obclient> DROP TENANT t1 PURGE;

  ```
 - 立刻删除租户 `t1`。

  ```sql
  obclient> DROP TENANT t1 FORCE;

  ```

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