#DELETE

DELETE用于在单机部署中的主库或存算一体分布式集群部署处于正常运行状态时删除指定的备份集。

在共享集群/分布式集群部署中，在备集群实例上执行删除时连接的目标节点必须为MASTER ROLE节点（可通过查询视图V$INSTANCE的INSTANCE_ROLE字段确定）。

语法图

代码

syntax

指定的tag_name不存在时，本命令报错。

指定IF EXISTS表示若备份集存在则尝试删除，不论tag_name是否存在都返回删除成功。

示例

$ yasrman sys/********@192.168.1.2:1688 -c "DELETE BACKUPSET tag 'full_1'" -D /home/yashan/catalog

# PARAMS

该语句用于对接第三方备份软件，指定XBSA接口的配置参数可远程管理三方备份软件端的备份集。

存算一体分布式集群部署中无法使用该语句。

格式如下： PARAMS 'XBSA_LIBRARY=xbsa_library_path, TOKEN=token_value, ENV=(key1=val1,key2=val2,...)'

xbsa_library_path：XBSA接口链接三方的动态链接库，必须指定为绝对路径或者LIB名。
token_value：BSAInit接口的token入参。
keyX, valX: BSAInit接口env入参，采用键值对格式输入，value内容中不能包含英文逗号。多个键值对之间使用英文逗号,分隔，逗号前后、键值对的=前后不能有空格。所有键值对的最大总长度需小于4096字节。

当前数据库已经支持S3协议的对象存储服务，其中XBSA_LIBRARY需指定S3的lib_xbsa_example.so动态库文件，参数介绍参考如下：

参数名	说明	示例
`S3_ENDPOINT`	S3服务地址（URL）	`http://192.168.1.100:9000`
`S3_BUCKET`	存储桶名称	`yashan-backup`
`S3_AK`	Access Key（访问密钥ID）	`admin`
`S3_SK`	Secret Key（访问密钥密码）	`MinioStrongPassword123`
`S3_REGION`	可选参数，区域（部分S3服务需要）	`us-east-1`

示例（单机、共享集群部署）

$ yasrman sys/********@192.168.1.2:1688 -c "delete backupset tag 's3_full_1' params 'XBSA_LIBRARY=/home/yashan/lib/lib_xbsa_example.so, TOKEN=NULL, ENV=(S3_ENDPOINT=http://192.168.1.100:9000,S3_BUCKET=yashan-backup,S3_AK=admin,S3_SK=MinioStrongPassword123)'" -D /home/yashan/catalog

delete backupset successfully

Note:

如果删除过程中断，可能出现部分节点的备份集已删除，但是剩余节点备份集和TAG还存在的情况，此时可以通过重新执行删除命令，继续删除。

如果catalog中存在备份集元信息，但数据库中没有记录元信息，不指定IF EXISTS删除备份集可能报错，请使用IF EXISTS来删除备份集。如果catalog文件被误删或者catalog和目标数据库备份集系统表不匹配，可使用该命令并且附加IF EXISTS来删除系统表信息。

仅使用该命令才可同时删除catalog和系统表中的备份集信息。