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

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