createNode()

名称

createNode - 在当前复制组中创建节点

语法

rg.createNode(<host>, <service>, <dbpath>, [config])

类别

SdbReplicaGroup

描述

该函数用于在当前复制组中创建节点。

参数

• host ( string，必填 )

  指定节点的主机名

• service ( number/string，必填 )

  节点端口号

• dbpath ( string，必填 )

  • 数据文件路径，用于存放节点数据文件，请确保数据管理员（安装时创建，默认为 sdbadmin）用户有写权限
  • 如果配置路径不以“/”开头，数据文件存放路径将是数据库管理员用户（默认为 sdbadmin）的主目录（默认为/home/sequoiadb）+ 配置的路径

• config ( object，选填 )

  节点配置信息，如配置日志大小，是否打开事务等，具体可参考数据库配置

Note:
rg.createNode() 方法的定义格式有四个参数：host，service，dbpath，config，如上表所示，host，dbpath 为字符串类型，Service 类型支持 number 或 string ，必填；最后一个是 object 对象，选填。
格式：("<主机名>", "<端口号>", "<节点路径>, "[{<configParam>: value, ...}])

返回值

函数执行成功时，将返回一个 SdbNode 类型的对象。

函数执行失败时，将抛异常并输出错误信息。

错误

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

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v2.0 及以上版本

示例

在复制组 group1 中创建一个 "hostname1:11830" 的节点，指定日志文件大小为64MB

> var rg = db.getRG("group1")
> rg.createNode("hostname1", 11830, "/opt/sequoiadb/database/data/11830", {logfilesz: 64})

Note:

一个复制组中能创建多个节点，每个节点需要预留至少五个顺延的端口。因为系统为每个节点后台控制了五个通信接口。