Sdb()

Sdb()

名称

Sdb - SequoiaDB 连接对象。

语法

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

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

类别

Sdb

描述

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

参数

参数名	参数类型	默认值	描述	是否必填
hostname	string	localhost	主机名	否
svcname	int	11810	节点端口号	否
username	string	默认为空（’’）	用户名	否
password	string	默认为空（’’）	密码	否

Note:

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

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

返回值

成功：返回 Sdb 对象。

失败：抛出异常。

错误

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

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

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

常见错误可参考错误码。

版本

v1.12及以上版本。

示例

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