• forceStepUp()
    • 语法
    • 参数描述
    • 返回值
    • 示例

    forceStepUp()

    语法

    db.forceStepUp( [options] )

    在一个不具备选举条件的复制组中，强制将一个备节点升级为主节点。请谨慎使用该命令！

    参数描述

    参数名参数类型描述是否必填
    optionsJson 对象参数集合否
    • options 选项

    参数名参数类型描述默认值Secondsint强制升级为主节点的持续时间120

    Note:

    • 目前仅在 catalog 组中开放此功能。
    • 目标复制组中不能存在主节点，且其他节点的 LSN 不能比目标节点的 LSN 大。
    • 当持续时间到期，所有节点会重新按照选举规则进行选举。
    • 如果创建了用户，无法直接连接 catalog 节点。可以先修改 catalog 节点的配置文件中的 auth 参数，配置 auth=false 关闭 catalog 的鉴权功能，重启集群后再进行操作。

    返回值

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

    示例

    • 连接 catalog 节点（hostname1:30000），并使其强制升主，持续300s。
    1. > var db = new Sdb( "hostname1", 30000 ) ;
    2. > db.forceStepUp( { Seconds: 300 } );