文档中心

SequoiaDB 简介

快速入门

安装部署

数据库实例

分布式引擎

SAC管控中心

SequoiaPerf性能分析工具

参考手册

常见问题及解答(FAQ)

版本信息

sync()

名称

sync - 持久化数据和日志到磁盘

语法

db.sync( [options] )

类别

Sdb

描述

该函数用于持久化数据和日志到磁盘。

参数

参数名 参数类型 描述 是否必填
options Json 对象 设定 深度刷盘阻塞模式指定集合空间 以及 命令位置参数
  1. Options 格式
属性名 描述 格式
Deep 是否开启深度刷盘,取值0/1/-1, 0表示不开启,1表示开启,-1表示采用服务器端默认配置。缺省为1。
Deep取值兼容bool类型。
Deep:1
Block 持久化期间是否阻塞所有的变更操作,取值true/false,缺省为false。 Block:false
CollectionSpace 指定持久化的集合空间名称,字符串类型。
如果指定该参数,则只会持久化该集合空间,否则会持久化所有的集合空间和日志文件。
CollectionSpace:"sample"
Location Elements 命令位置参数项,详细见 命令位置参数 GroupName:"db1"

返回值

函数执行成功时,无返回值。

函数执行失败时,将抛异常并输出错误信息。

错误

sync()函数常见异常如下:

错误码 错误类型 描述 解决方法
-67 SDB_BACKUP_HAS_ALREADY_START 与离线备份任务冲突。 关闭'阻塞模式'并重试。
-149 SDB_REBUILD_HAS_ALREADY_START 与本地重建任务冲突。 关闭'阻塞模式'并重试。
-148 SDB_DMS_STATE_NOT_COMPATIBLE 与其它阻塞操作冲突(如其它sync操作)。 关闭'阻塞模式'并重试。
-34 SDB_DMS_CS_NOTEXIST 指定集合空间不存在。 确认集合空间是否存在

当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南

版本

v2.8 及以上版本

示例

  1. 对全系统所有集合空间和日志进行深度持久化

    > db.sync()
  2. 对指定集合空间"sample"进行深度持久化

    > db.sync( { CollectionSpace : "sample" } )
  3. 对指定数据组"group1"进行深度加阻塞的持久化

    > db.sync( { GroupName : "group1", Block : true } )
回到顶部