手动清空备份路径或归档路径

替换备份路径或归档路径后，可以将替换掉的不再使用的数据备份路径或归档路径清空。清空数据备份路径或归档路径意味着清空该路径下的所有备份集或日志归档 Piece。

使用限制

• 仅支持清空被替换的备份或归档路径，不支持清空当前正在使用的备份或归档路径。

• 不支持将正在清空的旧路径重新设置为备份路径或归档路径。

清空备份路径

系统租户清空指定用户租户的备份路径

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

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2881 -uroot@sys -p***** -A
   

2. 查看租户信息，获取租户的 TENANT_ID。

   本文档以租户为 mysql001 为例，查询示例如下：

   obclient(root@sys)[(none)]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'mysql001';
   

   查询结果如下：

   +-----------+-------------+-------------+
   | TENANT_ID | TENANT_NAME | TENANT_TYPE |
   +-----------+-------------+-------------+
   |      1002 | mysql001    | USER        |
   +-----------+-------------+-------------+
   1 row in set
   

   根据查询结果，该租户的 TENANT_ID 为 1002。

3. 获取待清空的备份路径。

   1. 查看指定租户下的所有备份路径信息。

      obclient(root@sys)[(none)]> SELECT TENANT_ID, PATH, DEST_TYPE, STATUS FROM oceanbase.CDB_OB_BACKUP_STORAGE_INFO WHERE TENANT_ID = 1002 AND DEST_TYPE = 'backup_data';
      

      查询结果如下：

      +-----------+-------------------------------+-------------+--------+
      | TENANT_ID | PATH                          | DEST_TYPE   | STATUS |
      +-----------+-------------------------------+-------------+--------+
      |      1002 | file:///data/nfs/backup/data2 | backup_data | NORMAL |
      |      1002 | file:///data/nfs/backup/data1 | backup_data | NORMAL |
      +-----------+-------------------------------+-------------+--------+
      2 rows in set
      

      根据查询结果，该租户下有 2 条备份路径信息。

   2. 查看指定租户当前正在使用的备份路径。

      obclient(root@sys)[(none)]> SELECT * FROM oceanbase.CDB_OB_BACKUP_PARAMETER WHERE TENANT_ID = 1002;
      

      查询结果如下：

      +-----------+------------------+-------------------------------+
      | TENANT_ID | NAME             | VALUE                         |
      +-----------+------------------+-------------------------------+
      |      1002 | data_backup_dest | file:///data/nfs/backup/data2 |
      +-----------+------------------+-------------------------------+
      1 row in set
      

      根据查询结果，正在使用的备份路径是 file:///data/nfs/backup/data2，故待清空的备份路径 file:///data/nfs/backup/data1 不是正在使用的备份路径，可以清空。

4. 执行以下命令，清空指定的备份路径。

   语句如下：

   ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST [=] 'data_backup_path' TENANT [=] tenant_name;
   

   其中：

   • data_backup_path：指定待清空的数据备份路径。

   • tenant_name：指定待清空数据备份路径的用户租户。

   示例如下：

   OSS

   NFS

   系统租户清空租户 mysql001 的 OSS 备份路径 oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com。

   obclient(root@sys)[(none)]> ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST ='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com' TENANT = mysql001;
   

   系统租户清空租户 mysql001 的 NFS 备份路径 file:///data/nfs/backup/data1。

   obclient(root@sys)[(none)]> ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST ='file:///data/nfs/backup/data1' TENANT = mysql001;
   

5. 命令执行成功后，可以通过视图查看正在清空的路径信息。

   obclient(root@sys)[(none)]> SELECT TENANT_ID, PATH, DEST_TYPE, STATUS FROM oceanbase.CDB_OB_BACKUP_STORAGE_INFO WHERE TENANT_ID = 1002 AND PATH = 'file:///data/nfs/backup/data1';
   

   查询结果的示例如下：

   +-----------+-------------------------------+-------------+----------+
   | TENANT_ID | PATH                          | DEST_TYPE   | STATUS   |
   +-----------+-------------------------------+-------------+----------+
   |      1002 | file:///data/nfs/backup/data1 | backup_data | DELETING |
   +-----------+-------------------------------+-------------+----------+
   1 row in set
   

   根据查询结果可知，清空路径过程中，可以看到对应路径的 STATUS 字段的值变为 DELETING。待清空完成，对应的行将会被删除。

用户租户清空本租户的备份路径

1. 用户租户的租户管理员登录到数据库。

   说明

   MySQL 租户的管理员用户为 root 用户，Oracle 租户的管理员用户为 SYS 用户。

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2881 -uroot@mysql001 -p***** -A
   

2. 获取待清空的备份路径。

   1. 查看本租户下的所有备份路径信息。

      MySQL 模式

      Oracle 模式

      MySQL 模式下的查询示例如下：

      obclient(root@mysql001)[(none)]> SELECT PATH, DEST_TYPE, STATUS FROM oceanbase.DBA_OB_BACKUP_STORAGE_INFO WHERE DEST_TYPE = 'backup_data';
      

      Oracle 模式下的查询示例如下：

      obclient(SYS@oracle001)[SYS]> SELECT TENANT_ID, PATH, DEST_TYPE, STATUS FROM SYS.DBA_OB_BACKUP_STORAGE_INFO WHERE DEST_TYPE = 'backup_data'\G
      

      查询结果的示例如下：

      +-------------------------------+-------------+--------+
      | PATH                          | DEST_TYPE   | STATUS |
      +-------------------------------+-------------+--------+
      | file:///data/nfs/backup/data2 | backup_data | NORMAL |
      | file:///data/nfs/backup/data1 | backup_data | NORMAL |
      +-------------------------------+-------------+--------+
      2 rows in set
      

      根据查询结果，该租户下有 2 条备份路径信息。

   2. 查看本租户当前正在使用的备份路径。

      MySQL 模式

      Oracle 模式

      MySQL 模式下的查询示例如下：

      obclient(root@mysql001)[(none)]> SELECT * FROM oceanbase.DBA_OB_BACKUP_PARAMETER;
      

      Oracle 模式下的查询示例如下：

      obclient(SYS@oracle001)[SYS]> SELECT * FROM SYS.DBA_OB_BACKUP_PARAMETER;
      

      查询结果的示例如下：

      +------------------+-------------------------------+
      | NAME             | VALUE                         |
      +------------------+-------------------------------+
      | data_backup_dest | file:///data/nfs/backup/data2 |
      +------------------+-------------------------------+
      1 row in set
      

      根据查询结果，正在使用的备份路径是 file:///data/nfs/backup/data2，故待清空的备份路径 file:///data/nfs/backup/data1 不是正在使用的备份路径，可以清空。

3. 执行以下命令，清空指定的备份路径。

   语句如下：

   ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST [=] 'data_backup_path';
   

   其中，data_backup_path 用于指定待清空的数据备份路径。

   示例如下：

   OSS

   NFS

   用户租户清空本租户的 OSS 备份路径 oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com。

   obclient> ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST ='oss://oceanbase-test-bucket/backup/data?host=****.aliyun-inc.com';
   

   用户租户清空本租户的 NFS 备份路径 file:///data/nfs/backup/data1。

   obclient> ALTER SYSTEM DELETE BACKUP ALL DATA_BACKUP_DEST ='file:///data/nfs/backup/data1';
   

4. 命令执行成功后，可以通过视图查看正在清空的路径信息。

   MySQL 模式

   Oracle 模式

   MySQL 模式下的查询示例如下：

   obclient(root@mysql001)[(none)]> SELECT PATH, DEST_TYPE, STATUS FROM oceanbase.DBA_OB_BACKUP_STORAGE_INFO WHERE PATH = 'file:///data/nfs/backup/data1';
   

   Oracle 模式下的查询示例如下：

   obclient(SYS@oracle001)[SYS]> SELECT PATH, DEST_TYPE, STATUS FROM SYS.DBA_OB_BACKUP_STORAGE_INFO WHERE PATH = 'file:///data/nfs/backup/data1';
   

   查询结果的示例如下：

   +-------------------------------+-------------+----------+
   | PATH                          | DEST_TYPE   | STATUS   |
   +-------------------------------+-------------+----------+
   | file:///data/nfs/backup/data1 | backup_data | DELETING |
   +-------------------------------+-------------+----------+
   1 row in set
   

   根据查询结果可知，清空路径过程中，可以看到对应路径的 STATUS 字段的值变为 DELETING。待清空完成，对应的行将会被删除。

清空归档路径

系统租户清空指定用户租户的归档路径

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

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2881 -uroot@sys -p***** -A
   

2. 查看租户信息，获取租户的 TENANT_ID。

   本文档以租户为 mysql001 为例，查询示例如下：

   obclient(root@sys)[(none)]> SELECT TENANT_ID, TENANT_NAME, TENANT_TYPE FROM oceanbase.DBA_OB_TENANTS WHERE TENANT_NAME = 'mysql001';
   

   查询结果如下：

   +-----------+-------------+-------------+
   | TENANT_ID | TENANT_NAME | TENANT_TYPE |
   +-----------+-------------+-------------+
   |      1002 | mysql001    | USER        |
   +-----------+-------------+-------------+
   1 row in set
   

   根据查询结果，该租户的 TENANT_ID 为 1002。

3. 获取待清空的归档路径。

   1. 查看指定租户的所有归档路径。

      obclient(root@sys)[(none)]> SELECT TENANT_ID, PATH, DEST_TYPE, STATUS FROM oceanbase.CDB_OB_BACKUP_STORAGE_INFO WHERE TENANT_ID = 1002 AND DEST_TYPE = 'archive_log';
      

      查询结果的示例如下：

      +-----------+----------------------------------+-------------+---------+
      | TENANT_ID | PATH                             | DEST_TYPE   | STATUS  |
      +-----------+----------------------------------+-------------+---------+
      |      1002 | file:///data/nfs/backup/archive2 | archive_log | NORMAL  |
      |      1002 | file:///data/nfs/backup/archive1 | archive_log | NORMAL  |
      +-----------+----------------------------------+-------------+---------+
      1 row in set
      

      根据查询结果，该租户下有 2 条归档路径信息。

   2. 查看指定租户下正在使用的归档路径。

      obclient(root@sys)[(none)]> SELECT TENANT_ID, NAME, VALUE FROM oceanbase.CDB_OB_ARCHIVE_DEST WHERE TENANT_ID = tenant_id AND NAME = 'path';
      

      查询结果的示例如下：

      +-----------+------+------------------------------------+
      | TENANT_ID | NAME | VALUE                              |
      +-----------+------+------------------------------------+
      |      1002 | path | file:///data/nfs/backup/archive2   |
      +-----------+------+------------------------------------+
      1 row in set
      

      根据查询结果，正在使用的归档路径是 file:///data/nfs/backup/archive2，待清空的路径 file:///data/nfs/backup/archive1 不是正在使用的归档路径，可以清空。

4. 执行以下命令，清空指定的归档路径。

   语句如下：

   ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST [=] 'log_archive_path' TENANT [=] tenant_name;
   

   其中：

   • log_archive_path：指定待清空的归档路径。

   • tenant_name：指定待清空归档路径的用户租户。

   示例如下：

   OSS

   NFS

   系统租户清空租户 mysql001 的 OSS 归档路径 oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com。

   obclient(root@sys)[(none)]> ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST ='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com' TENANT = mysql001;
   

   系统租户清空租户 mysql001 的 NFS 归档路径 file:///data/nfs/backup/archive1。

   obclient(root@sys)[(none)]> ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST ='file:///data/nfs/backup/archive1' TENANT = mysql001;
   

5. 命令执行成功后，可以通过视图查看正在清空的路径信息。

   obclient(root@sys)[(none)]> SELECT TENANT_ID, PATH, DEST_TYPE, STATUS FROM oceanbase.CDB_OB_BACKUP_STORAGE_INFO WHERE TENANT_ID = 1002 AND PATH = 'file:///data/nfs/backup/archive1';
   

   查询结果的示例如下：

   +-----------+----------------------------------+-------------+-----------+
   | TENANT_ID | PATH                             | DEST_TYPE   | STATUS    |
   +-----------+----------------------------------+-------------+-----------+
   |      1002 | file:///data/nfs/backup/archive1 | archive_log | DELETING  |
   +-----------+----------------------------------+-------------+-----------+
   1 row in set
   

   根据查询结果可知，清空路径过程中，可以看到对应路径的 STATUS 字段的值变为 DELETING。待清空完成，对应的行将会被删除。

用户租户清空本租户的归档路径

1. 用户租户的租户管理员登录到数据库。

   说明

   MySQL 租户的管理员用户为 root 用户，Oracle 租户的管理员用户为 SYS 用户。

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2881 -uroot@mysql001 -p***** -A
   

2. 获取待清空的归档路径。

   1. 查看本租户的所有归档路径。

      MySQL 模式

      Oracle 模式

      MySQL 模式下的查询示例如下：

      obclient(root@mysql001)[(none)]> SELECT PATH, DEST_TYPE, STATUS FROM oceanbase.DBA_OB_BACKUP_STORAGE_INFO WHERE DEST_TYPE = 'archive_log';
      

      Oracle 模式下的查询示例如下：

      obclient(SYS@oracle001)[SYS]> SELECT PATH, DEST_TYPE, STATUS FROM SYS.DBA_OB_BACKUP_STORAGE_INFO WHERE DEST_TYPE = 'archive_log';
      

      查询结果的示例如下：

      +----------------------------------+-------------+---------+
      | PATH                             | DEST_TYPE   | STATUS  |
      +----------------------------------+-------------+---------+
      | file:///data/nfs/backup/archive2 | archive_log | NORMAL  |
      | file:///data/nfs/backup/archive1 | archive_log | NORMAL  |
      +----------------------------------+-------------+---------+
      2 rows in set
      

   2. 查看本租户当前正在使用的归档路径。

      MySQL 模式

      Oracle 模式

      MySQL 模式下的查询示例如下：

      obclient(root@mysql001)[(none)]> SELECT NAME, VALUE FROM oceanbase.DBA_OB_ARCHIVE_DEST WHERE NAME = 'path';
      

      Oracle 模式下的查询示例如下：

      obclient(SYS@oracle001)[SYS]> SELECT NAME, VALUE FROM SYS.DBA_OB_ARCHIVE_DEST WHERE NAME = 'path';
      

      查询结果的示例如下：

      +------+------------------------------------+
      | NAME | VALUE                              |
      +------+------------------------------------+
      | path | file:///data/nfs/backup/archive2   |
      +------+------------------------------------+
      1 row in set
      

      根据查询结果，确认待清理的备份路径不是正常使用的备份路径，可以清空。

3. 执行以下命令，清空指定的归档路径。

   语句如下：

   ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST [=] 'log_archive_path';
   

   其中，log_archive_path 用于指定待清空的归档路径。

   示例如下：

   OSS

   NFS

   用户租户清空本租户的 OSS 归档路径 oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com。

   obclient> ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST ='oss://oceanbase-test-bucket/backup/archive?host=****.aliyun-inc.com';
   

   用户租户清空本租户的 NFS 归档路径 file:///data/nfs/backup/archive1。

   obclient> ALTER SYSTEM DELETE BACKUP ALL LOG_ARCHIVE_DEST ='file:///data/nfs/backup/archive1';
   

4. 命令执行成功后，可以通过视图查看正在清空的路径信息。

   MySQL 模式

   Oracle 模式

   MySQL 模式下的查询示例如下：

   obclient(root@mysql001)[(none)]> SELECT PATH, DEST_TYPE, STATUS FROM oceanbase.DBA_OB_BACKUP_STORAGE_INFO WHERE PATH = 'file:///data/nfs/backup/archive1';
   

   Oracle 模式下的查询示例如下：

   obclient(SYS@oracle001)[SYS]> SELECT PATH, DEST_TYPE, STATUS FROM SYS.DBA_OB_BACKUP_STORAGE_INFO WHERE PATH = 'file:///data/nfs/backup/archive1';
   

   查询结果的示例如下：

   +----------------------------------+-------------+-----------+
   | PATH                             | DEST_TYPE   | STATUS    |
   +----------------------------------+-------------+-----------+
   | file:///data/nfs/backup/archive1 | archive_log | DELETING  |
   +----------------------------------+-------------+-----------+
   1 row in set
   

   根据查询结果可知，清空路径过程中，可以看到对应路径的 STATUS 字段的值变为 DELETING。待清空完成，对应的行将会被删除。

相关文档

• 查看备份清理进度

• 查看备份清理结果

• 取消清理任务