backup()

语法

db.backup([options])

类别

Sdb

备份数据库。

参数描述

• ( Object， 选填 )

  options参数可以设置备份的属性，如指定设定备份名，指定复制组，备份方式等。 可组合使用 options 的如下选项：

  1. GroupID ( Array )：指定备份的复制组 ID，缺省为所有复制组。

     格式：GroupID:1000 或 GroupID:[1000, 1001]

  2. GroupName ( String )：指定备份的复制组名，缺省为所有复制组。

     格式：GroupName: "data1" 或 GroupName: ["data1", "data2"]

  3. Name ( String )：备份名称，缺省为 “YYYY-MM-DD-HH:mm:SS” 时间格式的备份名。

     格式：Name: "backup-2014-1-1"

  4. 格式：

  5. IsSubDir ( Bool )：上述 Path 参数所配置的路径是否为配置参数指定的备份路径的子目录，如果为true，则真实的备份目录为：” 配置参数中指定的备份目录 / Path目录 “。 缺省为 false。

     格式：IsSubDir: false

  6. EnableDateDir ( Bool )：是否开启日期子目录功能，如果开启则会自动根据当前日期创建 “YYYY-MM-DD” 的子目录，缺省为 false。

     格式：EnableDateDir: false

  7. Description ( String )：备份描述。

     格式：Description: "First backup"

  8. EnsureInc ( Bool )：是否开启增量备份，缺省为 false。

     格式：

  9. 格式：OverWrite: false

  10. Compressed ( Bool )：是否开启数据压缩，缺省为 true。

      格式：Compressed: true

  11. CompressionType ( String )：压缩格式类型，取值”lz4”、”snappy”和”zlib”，缺省为 “snappy”。

      格式：CompressionType: "zlib"

  12. BackupLog ( Bool )：当全量备份时是否需要备份所有日志，缺省为 false。

      格式：BackupLog: false

返回值

成功：返回新集合的对象。

失败：抛出异常。

backup()函数常见异常如下：

当异常抛出时，可以通过getLastError()获取， 或通过getLastErrMsg()获取错误信息。 可以参考了解更多内容。

版本

示例