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")