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