• listNodes()
    • 语法
    • 类别
    • 描述
    • 参数
    • 返回值
    • 错误
    • 示例

    listNodes()

    语法

    Sdbtool.listNodes( [options], [filter], [rootPath] )

    类别

    Sdbtool

    描述

    显示节点信息

    参数

    参数名参数类型默认值描述是否必填
    optionsJSON默认显示数据节点，协调节点和编目节点的信息显示指定类型的节点的信息否
    filterJSON默认显示全部内容筛选条件否
    rootPathstring默认系统配置文件路径指定配置文件根路径否

    options 参数详细说明如下：

    属性值类型默认值格式描述
    typestringdb{ type: "all" }{ type: "db" }{ type: "om" }{ type: "cm" }显示所有节点的信息显示数据节点，协调节点和编目节点的信息显示 om 节点的信息显示 cm 节点的信息
    modestringrun{ mode: "run" }{ mode: "local" }显示正在运行的节点的信息显示本地节点的信息，无论是否正在运行
    rolestring空{ role: "data" }{ role: "coord" }{ role: "catalog" }{ role: "standalone" }{ role: "om" }{ role: "cm" }显示数据节点的信息显示协调节点的信息显示编目节点的信息显示 standalone 节点的信息显示 om 节点的信息显示 cm 节点的信息
    svcnamestring空{ svcname: "11790" }显示指定端口节点的信息
    showaloneboolfalse{ showalone：true }{ showalone: false }是否显示以 standalone 模式启动的 cm 节点的信息
    expandboolfalse{ expand: true }{ expand: false }是否显示详细的扩展配置

    Note：

    1. cm 有 standalone 的启动模式。除了当前的 cm 之外，还可以通过 standalone 模式再启动一个 cm 作为临时 cm (启动 cm 的时候指定 standalone 参数)，默认存活时间为 5 分钟。

    2. 当指定多个 svcname 时，可以以 ‘,’ 隔开。

    3. filter 参数支持对结果中的某些字段进行 and 、 or 、not 和精确匹配计算，对结果集进行筛选。

    返回值

    返回节点信息。

    错误

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

    常见错误可参考错误码。

    示例

    • 显示节点信息；
    1. > Sdbtool.listNodes( { type: "all", mode: "local", role: "data", svcname: "20000, 40000" } )
    2. {
    3.   "svcname": "20000",
    4.   "type": "sequoiadb",
    5.   "role": "data",
    6.   "pid": 17390,
    7.   "groupid": 1000,
    8.   "nodeid": 1000,
    9.   "primary": 1,
    10.   "isalone": 0,
    11.   "groupname": "db1",
    12.   "starttime": "2019-05-31-17.14.14",
    13.   "dbpath": "/opt/trunk/database/20000/"
    14. }
    15. {
    16.   "svcname": "40000",
    17.   "type": "sequoiadb",
    18.   "role": "data",
    19.   "pid": 17399,
    20.   "groupid": 1001,
    21.   "nodeid": 1001,
    22.   "primary": 0,
    23.   "isalone": 0,
    24.   "groupname": "db2",
    25.   "starttime": "2019-05-31-17.14.14",
    26.   "dbpath": "/opt/trunk/database/40000/"
    27. }
    • 显示节点信息后，对结果进行筛选。
    1. > Sdbtool.listNodes( { type: "all", mode: "local", role: "data", svcname: "20000, 40000" }, { groupname: "db2" } )
    2. {
    3.   "svcname": "40000",
    4.   "type": "sequoiadb",
    5.   "role": "data",
    6.   "pid": 17399,
    7.   "groupid": 1001,
    8.   "nodeid": 1001,
    9.   "primary": 0,
    10.   "isalone": 0,
    11.   "groupname": "db2",
    12.   "starttime": "2019-05-31-17.14.14",
    13.   "dbpath": "/opt/trunk/database/40000/"
    14. }