删除租户

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

使用限制

对于主备库配置场景，仅支持在主集群上删除租户，不支持在备集群上执行租户删除操作。

通过 SQL 语句删除租户

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

注意

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

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

obclient> DROP TENANT tenant_name [FORCE | PURGE]

其中：

• 对于 DROP TENANT 操作：

  • 当系统租户开启回收站功能时，DROP TENANT 操作表示删除的租户会进入回收站。对于回收站中的租户，后续系统租户可以通过租户级回收站功能进一步删除或恢复该租户，租户级回收站相关操作请参见 租户回收站。

  • 当系统租户关闭回收站功能时，DROP TENANT 操作表示延迟删除租户，后台线程会进行 GC（Garbage Collection）动作，租户的信息仍然可以通过内部表查询。租户具体延迟删除的时间由配置项 schema_history_expire_time 控制，默认为 7 天，表示执行 DROP TENANT 7 天后，租户会被删除，租户下的数据库和表也同时被删除。

    schema_history_expire_time 配置项更多信息请参见 schema_history_expire_time。

• PURGE 操作表示仅延迟删除租户，且无论系统租户是否开启回收站功能，删除的租户均不进入回收站。

• FORCE 参数表示无论系统租户是否开启回收站功能，均可以立刻删除租户。

使用示例

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

  obclient> DROP TENANT t1;
  

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

  obclient> DROP TENANT t1 PURGE;
  

• 立刻删除租户 t1。

  obclient> DROP TENANT t1 FORCE;
  

通过 OCP 删除租户

您可以通过 OCP 立即删除指定的租户。删除后，该租户将无法恢复。

前提条件

在删除租户前，需要确认以下信息：

• 请确认当前 OCP 用户具备系统管理员角色、OCP 租户管理员角色或其他拥有管理该集群权限的角色。如果没有相应权限的角色，请联系管理员为您添加，具体操作方法请参见 OCP 对应版本的《用户指南》文档中的 编辑用户 。

• 对于主备库配置的场景，当前仅支持对主集群执行租户删除操作，不支持对备集群执行租户删除操作。

操作步骤

1. 登录 OCP。

2. 在左侧导航栏单击 租户，进入租户概览页面。

3. 在 租户列表 区域选择需要删除的租户，进入租户详情页面。

4. 单击页面右上角 删除租户。

   

5. 在弹出框中输入 delete。

6. 单击 删除 。