listNodes()

名称

listNodes - 列出当前所连 sdbcm 所在机器符合条件的所有节点的信息。

语法

oma.listNodes([options],[filter])

类别

Oma

描述

列出当前所连 sdbcm 所在机器符合条件的所有节点的信息。

参数

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

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 和精确匹配计算，对结果集进行筛选。

返回值

成功：返回 sdbcm 所在机器符合条件的所有节点信息。

失败：无。

错误

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

常见错误可参考错误码。

版本

v2.0及以上版本。

示例

  1. 连接到本地的集群管理服务进程 sdbcm，获取 11820 节点的信息。

    1. > var oma = new Oma( "localhost", 11790 )
    2. > oma1.listNodes( { "svcname": '11820'} )
    3. {
    4.   "svcname": "11820",
    5.   "type": "sequoiadb",
    6.   "role": "data",
    7.   "pid": 23240,
    8.   "groupid": 1000,
    9.   "nodeid": 1000,
    10.   "primary": 0,
    11.   "isalone": 0,
    12.   "groupname": "group1",
    13.   "starttime": "2010-02-05-15.42.00",
    14.   "dbpath": "/opt/sequoiadb/database/data/11820/"
    15. }