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. }