listBackup()

语法

db.listBackup( [options], [cond], [sel], [sort] )

枚举数据库备份。

参数描述

参数名参数类型描述是否必填
optionsJson 对象指定备份名、复制组、路径等参数否
condJson 对象备份过滤条件否
selJson 对象选择备份输出的字段否
sortJson 对象对返回的记录按选定的字段排序。1为升序；-1为降序。否

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目录 “；缺省为 falseIsSubDir:false
Prefix备份前缀名，支持通配符（%g,%G,%h,%H,%s,%S），缺省为空Prefix:”%gbk“
Detail是否显示详细信息，缺省为 falseDetail: true

返回值

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

错误

常见错误可参考错误码。

示例

  • 查看数据库配置参数指定的备份路径下的所有备份信息

    1. > db.listBackup()
    2. {
    3.   "Version": 2,
    4.   "Name": "test",
    5.   "ID": 0,
    6.   "NodeName": "vmsvr2-suse-x64-1:20000",
    7.   "GroupName": "db1",
    8.   "EnsureInc": false,
    9.   "BeginLSNOffset": 195652020,
    10.   "EndLSNOffset": 195652068,
    11.   "TransLSNOffset": -1,
    12.   "StartTime": "2017-06-20-13:02:22",
    13.   "LastLSN": 195652020,
    14.   "LastLSNCode": 1845751176,
    15.   "HasError": false
    16. }

  • 查看其它路径下的备份信息

    备份数据节点到其它路径

    1. > var datadb = new Sdb( "localhost", 20000 )
    2. > datadb.backup( { Path: "/tmp/sequoiadb_backup/20000" } )

    连接 coord 查看备份信息，listBackup 时需要指定 Path 参数，否则在默认路径下查找不到备份信息

    1. > var db = new Sdb( "localhost", 11810 ) 
    2. > db.listBackup( { Path: "/tmp/sequoiadb_backup/20000" } )
    3. {
    4.   "Version": 2,
    5.   "Name": "2017-10-26-10:14:11",
    6.   "ID": 0,
    7.   "NodeName": "ubuntu-test-03:20000",
    8.   "GroupName": "db1",
    9.   "EnsureInc": false,
    10.   "BeginLSNOffset": -1,
    11.   "EndLSNOffset": 375546828,
    12.   "TransLSNOffset": -1,
    13.   "StartTime": "2017-10-26-10:14:11",
    14.   "LastLSN": -1,
    15.   "LastLSNCode": 0,
    16.   "HasError": false
    17. }