---
title: "DROP TENANT - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: "DROP TENANT 描述 DROP TENANT 语句用于删除一个 OceanBase 数据库租户。 权限要求 仅 sys 租户的 root 用户（ root@sys ）可以删除租户，其他租户不支持删除租户。 语法 DROP TENANT [IF EXISTS] tenant_name [PURGE | FORC…"
---
切换语言

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

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

# DROP TENANT

更新时间：2026-04-16 00:11:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/1100.drop-tenant.md)  

## 描述

`DROP TENANT` 语句用于删除一个 OceanBase 数据库租户。

## 权限要求

仅 `sys` 租户的 `root` 用户（`root@sys`）可以删除租户，其他租户不支持删除租户。

## 语法

```sql
DROP TENANT [IF EXISTS] tenant_name [PURGE | FORCE];

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| tenant_name | 指定要删除的租户名。 |
| IF EXISTS | 如果该租户不存在，系统不报错，也不会执行任何操作，但会给出信息提示。 |
| PURGE | 表示删除租户，且删除后的租户一定不会进入回收站。当 `sys` 租户的回收站功能关闭时， `DROP TENANT` 语句与 `DROP TENANT... PURGE` 语句的效果一样。 |
| FORCE | 表示强制删除租户，无法保证物理备份数据的完整性。删除后的租户不会进入回收站。 |

## 示例

- 删除一个存在的租户

如果你确定要删除名为 `example_tenant` 的租户，并且该租户存在，可以使用以下命令：

```shell
obclient> DROP TENANT example_tenant;

```

- 删除一个可能不存在的租户

如果不确定租户 `unsure_tenant` 是否存在，可以使用 `IF EXISTS` 选项来避免在租户不存在时抛出错误：

```shell
obclient> DROP TENANT IF EXISTS unsure_tenant;

```

- 延迟删除租户

如果你想要延迟删除租户 `delayed_tenant`，并且确保它不会进入回收站，可以使用 `PURGE` 选项：

```shell
obclient> DROP TENANT delayed_tenant PURGE;

```

- 立刻删除租户

如果你需要立即删除租户 `immediate_tenant`，不论回收站是否启用，可以使用 `FORCE` 选项：

```shell
obclient> DROP TENANT immediate_tenant FORCE;

```

## 相关文档

- [删除租户](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218356)

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