文档中心

listNodes()

语法

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

类别

Sdbtool

描述

显示节点信息

参数

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

options 参数详细说明如下:

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

Note:

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

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

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

返回值

返回节点信息。

错误

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

常见错误可参考错误码

示例

  • 显示节点信息;

    > Sdbtool.listNodes( { type: "all", mode: "local", role: "data", svcname: "20000, 40000" } )
    {
      "svcname": "20000",
      "type": "sequoiadb",
      "role": "data",
      "pid": 17390,
      "groupid": 1000,
      "nodeid": 1000,
      "primary": 1,
      "isalone": 0,
      "groupname": "db1",
      "starttime": "2019-05-31-17.14.14",
      "dbpath": "/opt/trunk/database/20000/"
    }
    {
      "svcname": "40000",
      "type": "sequoiadb",
      "role": "data",
      "pid": 17399,
      "groupid": 1001,
      "nodeid": 1001,
      "primary": 0,
      "isalone": 0,
      "groupname": "db2",
      "starttime": "2019-05-31-17.14.14",
      "dbpath": "/opt/trunk/database/40000/"
    }
  • 显示节点信息后,对结果进行筛选。

    > Sdbtool.listNodes( { type: "all", mode: "local", role: "data", svcname: "20000, 40000" }, { groupname: "db2" } )
    {
      "svcname": "40000",
      "type": "sequoiadb",
      "role": "data",
      "pid": 17399,
      "groupid": 1001,
      "nodeid": 1001,
      "primary": 0,
      "isalone": 0,
      "groupname": "db2",
      "starttime": "2019-05-31-17.14.14",
      "dbpath": "/opt/trunk/database/40000/"
    }
回到顶部