删除租户

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

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

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

• 当系统租户关闭回收站功能时，DROP TENANT 操作会直接删除租户，租户下的数据库和表也同时被删除。

操作步骤

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

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

2. 进入 oceanbase 数据库。

   obclient [(none)]> USE oceanbase;
   

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

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

   obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS WHERE TENANT_NAME = 'mq_t1';
   +-----------+-------------+-------------+----------------------------+----------------------------+--------------+------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+
   | TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME                | MODIFY_TIME                | PRIMARY_ZONE | LOCALITY                     | PREVIOUS_LOCALITY | COMPATIBILITY_MODE | STATUS | IN_RECYCLEBIN | LOCKED | TENANT_ROLE | SWITCHOVER_STATUS | SWITCHOVER_EPOCH | SYNC_SCN            | REPLAYABLE_SCN      | READABLE_SCN        | RECOVERY_UNTIL_SCN  | LOG_MODE     | ARBITRATION_SERVICE_STATUS |
   +-----------+-------------+-------------+----------------------------+----------------------------+--------------+------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+
   |      1036 | mq_t1       | USER        | 2023-05-18 15:48:57.447657 | 2023-05-18 15:49:12.857944 | zone1;zone2  | FULL{1}@zone1, FULL{1}@zone2 | NULL              | MYSQL              | NORMAL | NO            | NO     | PRIMARY     | NORMAL            |                0 | 1684396167132057328 | 1684396167132057328 | 1684396167051160964 | 4611686018427387903 | NOARCHIVELOG | DISABLED                   |
   +-----------+-------------+-------------+----------------------------+----------------------------+--------------+------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+
   1 row in set
   

   DBA_OB_TENANTS 视图的详细说明，参见 oceanbase.DBA_OB_TENANTS。

4. （可选）为防止恶意或误操作导致的数据不可恢复性丢失，OceanBase 数据库提供了租户级的回收站功能，从而支持租户级的数据的快速恢复功能。回收站默认关闭，您可以根据需要，开启租户级的回收站功能。有关回收站的详细说明，请参见 回收站。

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

   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 语句，删除租户。

   obclient> DROP TENANT mq_t1;
   

   DROP TENANT 语句的详细说明，参见 DROP TENANT。

6. 查看 DBA_OB_TENANTS 视图，确认租户已经删除成功。

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

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

   obclient [oceanbase]> SHOW RECYCLEBIN;
   +-------------------------------------+---------------+--------+----------------------------+
   | OBJECT_NAME                         | ORIGINAL_NAME | TYPE   | CREATETIME                 |
   +-------------------------------------+---------------+--------+----------------------------+
   | __recycle_$_100017_1673367572701376 | mq_t1         | TENANT | 2023-01-11 00:23:36.317242 |
   +-------------------------------------+---------------+--------+----------------------------+
   1 row in set
   

   回收站相关参数的详细说明，参见 recyclebin。

相关文档

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

• 恢复租户

• 回收站

• 恢复回收站对象