MySQL :: MySQL NDB 集群 API 开发者指南 :: 3.4 MGM API 数据结构

ndb_logevent 结构

描述: 此结构模拟集群日志事件，用于存储和检索日志事件信息。

定义。 ndb_logevent 有 8 个成员，前 7 个成员如下所示

void* handle：由 ndb_logevent_get_next() 设置的 NdbLogEventHandle。此句柄仅用于比较目的。
type：指示这是哪种类型的事件（Ndb_logevent_type）。
unsigned time：日志事件在管理服务器中注册的时间。
category：日志事件类别（ndb_mgm_event_category）。
severity：日志事件严重性（ndb_mgm_event_severity）。
unsigned level：日志事件级别。这是一个介于 0 到 15 之间的整数值（包括 0 和 15）。
unsigned source_nodeid：报告此事件的节点的节点 ID。

此结构的第 8 个成员包含特定于日志事件的数据，具体取决于其类型。它被定义为多个数据结构的联合，每个结构对应于一种日志事件类型。使用哪个结构由 type 的值确定，如下表所示

表 3.7 Ndb_logevent_type 类型值和使用的结构

`Ndb_logevent_type` 值	结构
`NDB_LE_Connected`	`Connected`: `unsigned node`
`NDB_LE_Disconnected`	`Disconnected`: `unsigned node`
`NDB_LE_CommunicationClosed`	`CommunicationClosed`: `unsigned node`
`NDB_LE_CommunicationOpened`	`CommunicationOpened`: `unsigned node`
`NDB_LE_ConnectedApiVersion`	`ConnectedApiVersion`: `unsigned node unsigned version`
`NDB_LE_GlobalCheckpointStarted`	`GlobalCheckpointStarted`: `unsigned gci`
`NDB_LE_GlobalCheckpointCompleted`	`GlobalCheckpointCompleted`: `unsigned gci`
`NDB_LE_LocalCheckpointStarted`	`LocalCheckpointStarted`: `unsigned lci unsigned keep_gci unsigned restore_gci`
`NDB_LE_LocalCheckpointCompleted`	`LocalCheckpointCompleted`: `unsigned lci`
`NDB_LE_LCPStoppedInCalcKeepGci`	`LCPStoppedInCalcKeepGci`: `unsigned data`
`NDB_LE_LCPFragmentCompleted`	`LCPFragmentCompleted`: `unsigned node unsigned table_id unsigned fragment_id`
`NDB_LE_UndoLogBlocked`	`UndoLogBlocked`: `unsigned acc_count unsigned tup_count`
`NDB_LE_NDBStartStarted`	`NDBStartStarted`: `unsigned version`
`NDB_LE_NDBStartCompleted`	`NDBStartCompleted`: `unsigned version`
`NDB_LE_STTORRYRecieved`	`STTORRYRecieved`: `[NONE]`
`NDB_LE_StartPhaseCompleted`	`StartPhaseCompleted`: `unsigned phase unsigned starttype`
`NDB_LE_CM_REGCONF`	`CM_REGCONF`: `unsigned own_id unsigned president_id unsigned dynamic_id`
`NDB_LE_CM_REGREF`	`CM_REGREF`: `unsigned own_id unsigned other_id unsigned cause`
`NDB_LE_FIND_NEIGHBOURS`	`FIND_NEIGHBOURS`: `unsigned own_id unsigned left_id unsigned right_id unsigned dynamic_id`
`NDB_LE_NDBStopStarted`	`NDBStopStarted`: `unsigned stoptype`
`NDB_LE_NDBStopCompleted`	`NDBStopCompleted`: `unsigned action unsigned signum`
`NDB_LE_NDBStopForced`	`NDBStopForced`: `unsigned action unsigned signum unsigned error unsigned sphase unsigned extra`
`NDB_LE_NDBStopAborted`	`NDBStopAborted`: `[NONE]`
`NDB_LE_StartREDOLog`	`StartREDOLog`: `unsigned node unsigned keep_gci unsigned completed_gci unsigned restorable_gci`
`NDB_LE_StartLog`	`StartLog`: `unsigned log_part unsigned start_mb unsigned stop_mb unsigned gci`
`NDB_LE_UNDORecordsExecuted`	`UNDORecordsExecuted`: `unsigned block unsigned data1 unsigned data2 unsigned data3 unsigned data4 unsigned data5 unsigned data6 unsigned data7 unsigned data8 unsigned data9 unsigned data10`
`NDB_LE_NR_CopyDict`	`NR_CopyDict`: `[NONE]`
`NDB_LE_NR_CopyDistr`	`NR_CopyDistr`: `[NONE]`
`NDB_LE_NR_CopyFragsStarted`	`NR_CopyFragsStarted`: `unsigned dest_node`
`NDB_LE_NR_CopyFragDone`	`NR_CopyFragDone`: `unsigned dest_node unsigned table_id unsigned fragment_id`
`NDB_LE_NR_CopyFragsCompleted`	`NR_CopyFragsCompleted`: `unsigned dest_node`
`NDB_LE_NodeFailCompleted`	`NodeFailCompleted`: `unsigned block unsigned failed_node unsigned completing_node` （对于 `block` 和 `completing_node`，`0` 被解释为 “全部”。）
`NDB_LE_NODE_FAILREP`	`NODE_FAILREP`: `unsigned failed_node unsigned failure_state`
`NDB_LE_ArbitState`	`ArbitState`: `unsigned code unsigned arbit_node unsigned ticket_0 unsigned ticket_1`
`NDB_LE_ArbitResult`	`ArbitResult`: `unsigned code unsigned arbit_node unsigned ticket_0 unsigned ticket_1`
`NDB_LE_GCP_TakeoverStarted`	`GCP_TakeoverStarted`: `[NONE]`
`NDB_LE_GCP_TakeoverCompleted`	`GCP_TakeoverCompleted`: `[NONE]`
`NDB_LE_LCP_TakeoverStarted`	`LCP_TakeoverStarted`: `[NONE]`
`NDB_LE_TransReportCounters`	`TransReportCounters`: `unsigned trans_count unsigned commit_count unsigned read_count unsigned simple_read_count unsigned write_count unsigned attrinfo_count unsigned conc_op_count unsigned abort_count unsigned scan_count unsigned range_scan_count`
`NDB_LE_OperationReportCounters`	`OperationReportCounters`: `unsigned ops`
`NDB_LE_TableCreated`	`TableCreated`: `unsigned table_id`
`NDB_LE_JobStatistic`	`JobStatistic`: `unsigned mean_loop_count`
`NDB_LE_SendBytesStatistic`	`SendBytesStatistic`: `unsigned to_node unsigned mean_sent_bytes`
`NDB_LE_ReceiveBytesStatistic`	`ReceiveBytesStatistic`: `unsigned from_node unsigned mean_received_bytes`
`NDB_LE_MemoryUsage`	`MemoryUsage`: `int gth unsigned page_size_kb unsigned pages_used unsigned pages_total unsigned block`
`NDB_LE_TransporterError`	`TransporterError`: `unsigned to_node unsigned code`
`NDB_LE_TransporterWarning`	`TransporterWarning`: `unsigned to_node unsigned code`
`NDB_LE_MissedHeartbeat`	`MissedHeartbeat`: `unsigned node unsigned count`
`NDB_LE_DeadDueToHeartbeat`	`DeadDueToHeartbeat`: `unsigned node`
`NDB_LE_WarningEvent`	`WarningEvent`: `[NOT YET IMPLEMENTED]`
`NDB_LE_SentHeartbeat`	`SentHeartbeat`: `unsigned node`
`NDB_LE_CreateLogBytes`	`CreateLogBytes`: `unsigned node`
`NDB_LE_InfoEvent`	`InfoEvent`: `[NOT YET IMPLEMENTED]`
`NDB_LE_EventBufferStatus` （NDB 7.5 之前版本）	`EventBufferStatus`: `unsigned usage unsigned alloc unsigned max unsigned apply_gci_l unsigned apply_gci_h unsigned latest_gci_l unsigned latest_gci_h`
`NDB_LE_EventBufferStatus2` （NDB 7.5）	`EventBufferStatus2`: `unsigned usage unsigned alloc unsigned max unsigned latest_consumed_epoch_l unsigned latest_consumed_epoch_h unsigned latest_buffered_epoch_l unsigned latest_buffered_epoch_h unsigned ndb_reference unsigned report_reason` `report_reason` 是 `NO_REPORT`、`COMPLETELY_BUFFERING`、`PARTIALLY_DISCARDING`、`COMPLETELY_DISCARDING`、`PARTIALLY_BUFFERING`、`BUFFERED_EPOCHS_OVER_THRESHOLD`、`ENOUGH_FREE_EVENTBUFFER` 或 `LOW_FREE_EVENTBUFFER` 之一；有关这些值的描述，请参见集群日志中的事件缓冲区报告
`NDB_LE_BackupStarted`	`BackupStarted`: `unsigned starting_node unsigned backup_id`
`NDB_LE_BackupFailedToStart`	`BackupFailedToStart`: `unsigned starting_node unsigned error`
`NDB_LE_BackupCompleted`	`BackupCompleted`: `unsigned starting_node unsigned backup_id unsigned start_gci unsigned stop_gci unsigned n_records unsigned n_log_records unsigned n_bytes unsigned n_log_bytes`
`NDB_LE_BackupAborted`	`BackupAborted`: `unsigned starting_node unsigned backup_id unsigned error`
`NDB_LE_SingleUser`	`SingleUser`: `unsigned type unsigned node_id`
`NDB_LE_StartReport`	`StartReport`: `unsigned report_type unsigned remaining_time unsigned bitmask_size unsigned bitmask_data[1]`

ndb_mgm_node_state 结构

描述: 提供有关集群节点状态的信息。

定义。 此结构包含以下成员

int node_id：集群节点的节点 ID。
enum ndb_mgm_node_type node_type：节点类型。

有关允许的值，请参见 ndb_mgm_node_type 类型。
enum ndb_mgm_node_status node_status：节点的状态。

有关允许的值，请参见 ndb_mgm_node_status 类型。
int start_phase：启动阶段。

仅当 node_type 为 NDB_MGM_NODE_TYPE_NDB 且 node_status 为 NDB_MGM_NODE_STATUS_STARTING 时，此字段才有效。
int dynamic_id：用于心跳和主服务器接管的 ID。

仅对数据（ndbd）节点有效。
int node_group：节点所属的节点组。

仅对数据（ndbd）节点有效。
int version：内部版本号。
int connect_count：此节点连接到或断开与管理服务器的次数。
char connect_address[]：集群中其他节点看到的此节点的 IP 地址。
int mysql_version：MySQL 版本号，表示为整数（例如：80200）。仅适用于 SQL 节点。
int is_single_user：当集群处于单用户模式时，具有独占访问权限的 API 或 SQL 节点的节点 ID。否则不适用。在 NDB 8.0 中添加。

ndb_mgm_node_state2 结构

描述: 提供有关集群节点状态的信息。

定义。 此结构包含以下成员

int node_id：集群节点的节点 ID。
enum ndb_mgm_node_type node_type：节点类型。

有关允许的值，请参见 ndb_mgm_node_type 类型。
enum ndb_mgm_node_status node_status：节点的状态。

有关允许的值，请参见 ndb_mgm_node_status 类型。
int start_phase：启动阶段。

仅当 node_type 为 NDB_MGM_NODE_TYPE_NDB 且 node_status 为 NDB_MGM_NODE_STATUS_STARTING 时，此字段才有效。
int dynamic_id：用于心跳和主服务器接管的 ID。

仅对数据（ndbd）节点有效。
int node_group：节点所属的节点组。

仅对数据（ndbd）节点有效。
int version：内部版本号。
int connect_count：此节点连接到或断开与管理服务器的次数。
int mysql_version：MySQL 版本号，表示为整数（例如：80200）。仅适用于 SQL 节点。
int is_single_user：当集群处于单用户模式时，具有独占访问权限的 API 或 SQL 节点的节点 ID。否则不适用。
char connect_address[]：集群中其他节点看到的此节点的 IP 地址。

ndb_mgm_cluster_state 结构

描述: 提供有关所有集群节点状态的信息。此结构由 ndb_mgm_get_status() 返回。

定义。 此结构有两个成员

int no_of_nodes：node_states 数组中的元素数。
struct ndb_mgm_node_state node_states[]：包含节点状态的数组。

此数组的每个元素都是一个 ndb_mgm_node_state 结构。

请参见 ndb_mgm_get_status()。

ndb_mgm_cluster_state2 结构

描述: 提供有关所有集群节点状态的信息。此结构由 ndb_mgm_get_status3() 返回，并在 NDB 8.0 中添加。

定义。 此结构有两个成员

int no_of_nodes：node_states 数组中的元素数。
struct ndb_mgm_node_state2 node_states[]：包含节点状态的数组。

此数组的每个元素都是一个 ndb_mgm_node_state2 结构。

请参见 ndb_mgm_get_status3()。

ndb_mgm_reply 结构

描述: 包含来自管理服务器的响应信息，包括响应代码和对应的消息。

定义。 此结构包含两个成员，如下所示

int return_code：对于成功的操作，此值为 0；否则，它包含一个错误代码。

有关错误代码，请参见 ndb_mgm_error 类型。
char message[256]：包含响应或错误消息的文本。

请参阅 ndb_mgm_get_latest_error() 和 ndb_mgm_get_latest_error_msg()。