• Sdb()
    • 名称
    • 语法
    • 类别
    • 描述
    • 参数
    • 返回值
    • 错误
    • 版本
    • 示例

    Sdb()

    名称

    Sdb - SequoiaDB 连接对象。

    语法

    var db = new Sdb([hostname],[svcname])

    var db = new Sdb([hostname],[svcname],[username],[password])

    类别

    Sdb

    描述

    新建一个 Sdb 对象，用于连接 SequoiaDB。

    参数

    参数名参数类型默认值描述是否必填
    hostnamestringlocalhost主机名否
    svcnameint11810节点端口号否
    usernamestring默认为空（''）用户名否
    passwordstring默认为空（''）密码否

    Note:

    1. 可以通过 createUsr() 创建 SequoiaDB 的用户，并设置对应的密码。

    2. 当 SequoiaDB 没有用户时，创建 Sdb 对象可以不使用 username 和 password，否则必须使用相应的 username 和 password 去创建 Sdb 对象。

    返回值

    成功：返回 Sdb 对象。

    失败：抛出异常。

    错误

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

    错误码错误类型描述解决方法
    -15SDB_NETWORK网络错误检查填写的地址或者端口是否可达。
    -79SDB_NET_CANNOT_CONNECT无法连接指定的地址检查地址、端口以及节点的配置信息是否正确。
    -104SDB_CLS_NOT_PRIMARY分区组不存在主节点检查当前分区组是否存在 "IsPrimary" 为 "true" 的节点。若当前分区组存在节点未启，请启动节点。
    -250SDB_CLS_NODE_BSFAULT节点状态不正确检查节点状态，如检查 catalog 节点是否启动。

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

    常见错误可参考错误码。

    版本

    v1.12及以上版本。

    示例

    • 连接默认主机上的 SequoiaDB，hostname 默认为 "localhost"，svcname 默认为 11810。
    1. > var db = new Sdb()
    • 连接指定机器上的 SequoiaDB，目标机器 "sdbserver1"。
    1. > var db = new Sdb("sdbserver1",11810)
    • 使用用户名和密码连接指定机器上的 SequoiaDB。
    1. > var db = new Sdb("sdbserver1",11810,"admin","123")