文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

forceStepUp()

名称

forceStepUp - 强制将备节点升级为主节点

语法

db.forceStepUp([options])

类别

Sdb

描述

该函数用于在一个不具备选举条件的复制组中,将备节点强制升级为主节点。升级前需确保目标节点 LSN 为组内最大值。如果将 LSN 较小的节点强制升主,将导致数据回滚。用户可通过节点健康检测快照获取节点 LSN 信息。

Note:

该函数仅支持在编目复制组中使用。

参数

options( object,选填

通过参数 options 可以指定主节点的持续时间:

  • Seconds( number ):强制升级为主节点的持续时间,单位为秒,默认值为 120

    当超过指定时间,复制组内将按选举规则重新选主。

    格式:Seconds: 300

返回值

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

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

错误

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

版本

v3.4 及以上版本

示例

  1. 连接编目节点 11800

    > var cata = new Sdb("localhost", 11800)

    Note:

    如果无法连接编目节点,需要将节点参数 auth 配置为 false,配置方式可参考参数配置

  2. 将编目节点 11800 强制升为主节点,并指定持续时间为 300 秒

    > cata.forceStepUp({Seconds: 300})
回到顶部