3.2.5 集群状态函数

本节提供有关用于从 NDB Cluster 节点获取状态信息的 MGM API 函数的信息。

ndb_mgm_get_status()

描述

此函数用于获取 NDB Cluster 中节点的状态。

笔记

调用者必须释放此函数返回的指针。

签名 
struct ndb_mgm_cluster_state* ndb_mgm_get_status
    (
      NdbMgmHandle handle
    )
参数

此函数采用单个参数，一个 management server handle。

返回值

指向 ndb_mgm_cluster_state 数据结构的指针。

ndb_mgm_get_status2()

描述

此功能类似于 ndb_mgm_get_status()，因为它用于获取 NDB Cluster 中节点的状态。但是， 允许指定要检查 ndb_mgm_get_status2()的节点 ( ) 的类型。ndb_mgm_node_type

笔记

调用者必须释放此函数返回的指针。

签名 
struct ndb_mgm_cluster_state* ndb_mgm_get_status2
    (
      NdbMgmHandle handle,
      const enum ndb_mgm_node_type types[]
    )
参数

这个函数有两个参数：

  • 管理服务器 handle

  • 指向要检查的节点类型数组的指针。这些是 ndb_mgm_node_type 价值观。该数组应以 类型的元素终止 NDB_MGM_NODE_TYPE_UNKNOWN。

返回值

指向 ndb_mgm_cluster_state 数据结构的指针。

ndb_mgm_dump_state()

描述

该函数可用于将调试信息转储到集群日志中。NDB Cluster 管理客户端 DUMP命令是此功能的包装器。

ndb_mgm_dump_state()和 DUMP命令一样，如果使用不当，可能会导致正在运行的 NDB Cluster 出现故障甚至完全失败。使用此功能前请务必查阅相关文档。有关该 DUMP命令的更多信息，以及当前DUMP代码及其效果的列表，请参阅NDB Cluster Management Client DUMP 命令。

签名 
int ndb_mgm_dump_state
    (
      NdbMgmHandle handle,
      int nodeId,
      const int* arguments,
      int numberOfArguments,
      struct ndb_mgm_reply* reply
    )
参数

此函数采用以下参数：

  • 管理服务器句柄 ( NdbMgmHandle)

  • nodeId集群数据节点的 。

  • 的数组arguments。其中第一个是DUMP 要执行的代码。DUMP如果相应命令 需要或需要，可以在此数组中传递后续参数 。

  • numberOfArguments要通过 的。

  • 一个ndb_mgm_reply，其中包含返回代码以及响应或错误消息。

返回值

0成功时；否则，错误代码。

例子。 2 DUMP 1000以下示例与在管理客户端 中运行的结果相同 ：

//  [...]
#include <mgmapi_debug.h>
//  [...]
struct ndb_mgm_reply reply;
int args[1];
int stat, arg_count, node_id;

args[0] = 1000;
arg_count = 1;
node_id = 2;

stat = ndb_mgm_dump_state(h, node_id, args, arg_count, &reply);