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

    forceSession()

    语法

    db.forceSession( <sessionID>, [options] )

    终止指定会话的当前操作。当不指定节点信息时,默认为对自身的会话进行操作。

    参数描述

    参数名参数类型描述是否必填
    sessionIDint会话编号
    optionsJson对象命令位置参数

    Note:

    • 只有用户会话可以被终止。
    • 会话编号可以通过list()或snapshot()获取。
    • options参数只在协调节点生效。
    • 如果终止的会话是当前会话,连接会被断开,不能再执行操作。

    返回值

    无返回值,出错抛异常,并输出错误信息。可以通过 getLastErrObj() 或 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。该操作主要的异常如下:

    • SDB_PMD_SESSION_NOT_EXIST(-62) 指定会话不存在: 1)需要确认指定会话对应的节点是否正确; 2)该节点上是否存在指定会话。
    • SDB_PMD_FORCE_SYSTEM_EDU(-63) 系统会话不能被终止。更多错误可以参考常见错误处理指南 。

    示例

    • 终止当前节点编号为30的会话。
    1. // 连接节点
    2. > db = new Sdb( "localhost", 11810 )
    3. // 终止指定会话
    4. > db.forceSession( 30 )
    • 终止节点ID为1000上的编号为30的会话。
    1. // 连接节点
    2. > db = new Sdb( "localhost", 11810 )
    3. // 终止编号为30的会话
    4. > db.forceSession( 30, {NodeID:1000} )