createCoord()

名称

createCoord - 在目标集群控制器（sdbcm）所在的机器中创建一个 coord 节点。

语法

oma.createCoord(<svcname>,<dbpath>,[config])

类别

Oma

描述

在目标集群控制器（sdbcm）所在的机器中创建一个 coord 节点。一般情况，通过该接口创建的 coord 节点只出于临时使用的目的。

Note:

  • oma 对象为连接到目标（本地/远端机器）集群控制器（sdbcm）获得的连接对象。

  • 通过该接口创建的 coord 节点并不会注册到 catalog 中，即该 coord 节点不能被集群管理。若希望 coord 节点能够被集群管理，需要使用createNode()接口来创建 coord 节点。

参数

  • svcname ( String， 必填 )

节点端口号。

  • dbpath ( String， 必填 )

节点数据目录。

  • config ( Object， 选填 )

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

返回值

成功：无。

失败：抛出异常。

错误

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

错误码错误类型描述解决方法
-3SDB_PERM权限错误。检查节点路径是否正确，路径权限是否正确。
-15SDB_NETWORK网络错误。1. 检查 sdbcm 状态是否正常，如果状态异常，可以尝试重启。2. 检查网络情况。
-145SDBCM_NODE_EXISTED节点已存在。检查节点是否存在。
-157SDB_CM_CONFIG_CONFLICTS节点配置冲突。检查端口号及数据目录是否已经被使用。

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

版本

v2.0及以上版本。

示例

  • 在本地创建一个端口号为11810的 coord 节点，将该节点关联到指定的 catalog 节点。
  1. > var oma = new Oma( "localhost", 11790 )
  2. > oma.createCoord( 11810, "/opt/sequoiadb/database/coord/11810", { catalogaddr: "ubuntu1:11823, ubuntu2:11823" } )