• removeBackup()
    • 语法
    • 参数描述
      • options 格式
    • 返回值
    • 错误
    • 版本
    • 示例

    removeBackup()

    语法

    db.removeBackup( [options] )

    删除数据库备份。

    参数描述

    参数名参数类型描述是否必填
    optionsJson 对象设定备份名、复制组、备份路径等参数

    options 格式

    属性名描述格式
    GroupID备份的复制组 ID,缺省为所有复制组GroupID:1000 或 GroupID:[1000, 1001]
    GroupName备份的复制组名,缺省为所有复制组GroupName:"data1" 或 GroupName:["data1", "data2"]
    Name备份名称,缺省删除所有备份Name:"backup-2014-1-1"
    Path备份路径,缺省为配置参数指定的备份路径。该路径支持通配符(%g/%G: group name, %h/%H: host name, %s/%S:service name)。当在协调节点上执行命令使用该参数时,需要使用通配符,以避免所有的节点往同一个路径下进行操作而导致未知IO错误。Path:"/opt/sequoiadb/backup/%g"
    IsSubDir上述 Path 参数所配置的路径是否为配置参数指定的备份路径的子目录,如果为true,则真实的备份目录为:" 配置参数中指定的备份目录 / Path目录 ";缺省为 false。IsSubDir:false
    Prefix备份前缀名,支持通配符(%g,%G,%h,%H,%s,%S),缺省为空Prefix:"%gbk"
    ID备份 ID,-1表示该名字的所有备份, 缺少为 -1ID: -1

    返回值

    无返回值,出错抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。关于错误处理可以参考常见错误处理指南。

    错误

    常见错误可参考错误码。

    版本

    v2.8.2及以上版本增加 ID 参数。

    示例

    • 删除数据库中备份名为“backup-2014-1-1”的备份信息
    1. > db.removeBackup({Name:"backup-2014-1-1"})