MySQL NDB Cluster API 开发人员指南  / 第 3 章 MGM API  /  3.3 MGM API 数据类型

3.3 MGM API 数据类型

本节提供有关 MGM API 定义的数据类型的信息。

本节中描述的类型均在文件中定义, 但、 、 和 /storage/ndb/include/mgmapi/mgmapi.h除外 Ndb_logevent_type, 它们在 . ndb_mgm_event_severityndb_mgm_logevent_handle_errorndb_mgm_event_category/storage/ndb/include/mgmapi/ndb_logevent.h

ndb_mgm_node_type 类型

描述

这用于对 NDB Cluster 中不同类型的节点进行分类。

枚举值

下表显示了可能的值以及说明:

表 3.1 类型 ndb_mgm_node_type 值和描述。

价值 描述
NDB_MGM_NODE_TYPE_UNKNOWN 未知
NDB_MGM_NODE_TYPE_API API节点(SQL节点)
NDB_MGM_NODE_TYPE_NDB 数据节点
NDB_MGM_NODE_TYPE_MGM 管理节点

ndb_mgm_node_status 类型

描述

这种类型描述了集群节点的状态。

枚举值

下表显示了可能的值以及说明:

表 3.2 键入 ndb_mgm_node_status 值和描述。

价值 描述
NDB_MGM_NODE_STATUS_UNKNOWN 节点状态未知
NDB_MGM_NODE_STATUS_NO_CONTACT 节点联系不上
NDB_MGM_NODE_STATUS_NOT_STARTED 该节点还没有执行启动协议
NDB_MGM_NODE_STATUS_STARTING 节点正在执行启动协议
NDB_MGM_NODE_STATUS_STARTED 节点正在运行
NDB_MGM_NODE_STATUS_SHUTTING_DOWN 节点正在关闭
NDB_MGM_NODE_STATUS_RESTARTING 节点正在重启
NDB_MGM_NODE_STATUS_SINGLEUSER 节点以单用户(维护)模式运行
NDB_MGM_NODE_STATUS_RESUME 节点处于恢复模式
NDB_MGM_NODE_STATUS_CONNECTED 节点已连接

ndb_mgm_error 类型

描述

此类型的值是可能由 MGM API 函数生成的错误代码。这些可以在 第 3.5 节“MGM API 错误”中找到。

有关详细信息,另请参阅ndb_mgm_get_latest_error()

Ndb_logevent_type 类型

描述

这些是 MGM API 中可用的日志事件类型,按事件类别分组。(请参阅 ndb_mgm_event_category 类型。)

大多数这些日志事件类型都有一个或多个对应的日志事件消息;这些列在 NDB Cluster Log Messages中。

枚举值

下表显示了可能的值以及说明:

表 3.3 类型 Ndb_logevent_type 值、描述和事件类别

类型 描述 类别
NDB_LE_Connected 节点已连接 NDB_MGM_EVENT_CATEGORY_CONNECTION
NDB_LE_Disconnected 节点已断开连接 NDB_MGM_EVENT_CATEGORY_CONNECTION
NDB_LE_CommunicationClosed 与节点的通信已关闭 NDB_MGM_EVENT_CATEGORY_CONNECTION
NDB_LE_CommunicationOpened 与节点的通信已经开始 NDB_MGM_EVENT_CATEGORY_CONNECTION
NDB_LE_ConnectedApiVersion API节点使用的API版本;在 MySQL 服务器(SQL 节点)的情况下,这与显示的相同 SELECT VERSION() NDB_MGM_EVENT_CATEGORY_CONNECTION
NDB_LE_GlobalCheckpointStarted 全局检查点已经启动 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_GlobalCheckpointCompleted 一个全局检查点已经完成 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_LocalCheckpointStarted 该节点已开始本地检查点 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_LocalCheckpointCompleted 该节点已完成本地检查点 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_LCPStoppedInCalcKeepGci lcoal 检查点已中止,但保留了最后一个全局检查点 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_LCPFragmentCompleted 表片段的复制已完成 NDB_MGM_EVENT_CATEGORY_CHECKPOINT
NDB_LE_NDBStartStarted 节点已经开始启动 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NDBStartCompleted 节点已完成启动过程 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_STTORRYRecieved 节点收到STTORRY信号,表示正在读取配置数据;有关更多信息,请参阅 配置读取阶段(STTOR 阶段 -1)STTOR 阶段 0 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_StartPhaseCompleted 一个节点启动阶段已经完成 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_CM_REGCONF 节点收到CM_REGCONF信号;有关详细信息,请参阅 STTOR 第 1 阶段 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_CM_REGREF 节点收到CM_REGREF信号;有关详细信息,请参阅 STTOR 第 1 阶段 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_FIND_NEIGHBOURS 该节点已发现其在集群中的相邻节点 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NDBStopStarted 节点开始关闭 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NDBStopCompleted 节点关闭完成 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NDBStopForced 节点被强制关闭(通常表示集群出现严重问题) NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NDBStopAborted 开始关机,却被迫继续运行;例如,当 STOP在节点的管理客户端中发出命令时,如果节点关闭,集群将不再能够保持所有数据可用,就会发生这种情况 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_StartREDOLog 重做日志记录已经开始 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_StartLog 记录已经开始 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_UNDORecordsExecuted 该节点已从重做日志中读取并执行了所有记录 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_StartReport 节点正在发出启动报告 NDB_MGM_EVENT_CATEGORY_STARTUP
NDB_LE_NR_CopyDict 节点正在复制数据字典 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NR_CopyDistr 节点正在复制数据分布信息 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NR_CopyFragsStarted 该节点正在复制表碎片 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NR_CopyFragDone 该节点已完成复制表片段 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NR_CopyFragsCompleted 该节点已完成复制所有必要的表片段 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NodeFailCompleted 所有(剩余)节点都已收到数据节点故障的通知 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_NODE_FAILREP 数据节点发生故障 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_ArbitState 该事件用于报告集群中当前的仲裁状态 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_ArbitResult 该事件用于报告节点仲裁结果 NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_GCP_TakeoverStarted 该节点正在尝试成为主节点(承担 GCP 的责任) NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_GCP_TakeoverCompleted 该节点已成为主节点(并承担了 GCP 的责任) NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_LCP_TakeoverStarted 该节点正在尝试成为主节点(承担 LCP 的责任) NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_LCP_TakeoverCompleted 该节点已成为主节点(并承担了 LCP 的责任) NDB_MGM_EVENT_CATEGORY_NODE_RESTART
NDB_LE_TransReportCounters 这表示交易活动的报告,大约每 10 秒给出一次 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_OperationReportCounters 指示有关此节点执行的操作数的报告(也大约每 10 秒提供一次) NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_TableCreated 已创建新表 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_UndoLogBlocked 撤消日志记录被阻止,因为日志缓冲区接近溢出 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_JobStatistic ... NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_SendBytesStatistic 指示此节点每次发送操作传输的平均字节数的报告 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_ReceiveBytesStatistic 指示每次向该节点发送操作接收到的平均字节数的报告 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_MemoryUsage DUMP 1000已向该节点发出命令,它正在依次报告其内存使用情况 NDB_MGM_EVENT_CATEGORY_STATISTIC
NDB_LE_TransporterError 发生传输器错误;请参阅 NDB Transporter Errors,了解传输错误代码和消息 NDB_MGM_EVENT_CATEGORY_ERROR
NDB_LE_TransporterWarning 传输器出现潜在问题;请参阅 NDB Transporter Errors,了解传输错误代码和消息 NDB_MGM_EVENT_CATEGORY_ERROR
NDB_LE_MissedHeartbeat 指示数据节点错过了另一个数据节点预期的 hreatbeat NDB_MGM_EVENT_CATEGORY_ERROR
NDB_LE_DeadDueToHeartbeat 一个数据节点连续错过了另一个数据节点的至少 3 次心跳,并且报告它无法再与该数据节点通信 NDB_MGM_EVENT_CATEGORY_ERROR
NDB_LE_WarningEvent 表示警告信息 NDB_MGM_EVENT_CATEGORY_ERROR
NDB_LE_SentHeartbeat 已发送节点心跳 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_CreateLogBytes ... NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_InfoEvent 指示信息性消息 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_SingleUser 集群进入或退出单用户模式 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_EventBufferStatus 这种类型的事件表示可能过度使用事件缓冲区 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_EventBufferStatus2 扩展NDB_LE_EventBufferStatus提供改进的事件缓冲区状态报告;在 NDB 7.5 中添加 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_EventBufferStatus3 其扩展NDB_LE_EventBufferStatus对总字节数、最大字节数和分配字节数使用 64 位值;在 NDB 7.5.23、7.6.19 和 8.0.26 中添加 NDB_MGM_EVENT_CATEGORY_INFO
NDB_LE_BackupStarted 备份已开始 NDB_MGM_EVENT_CATEGORY_BACKUP
NDB_LE_BackupFailedToStart 备份启动失败 NDB_MGM_EVENT_CATEGORY_BACKUP
NDB_LE_BackupCompleted 备份已成功完成 NDB_MGM_EVENT_CATEGORY_BACKUP
NDB_LE_BackupAborted 正在进行的备份被用户终止 NDB_MGM_EVENT_CATEGORY_BACKUP

ndb_mgm_event_severity 类型

描述

这些是用于过滤集群日志的日志事件严重性 ndb_mgm_set_clusterlog_severity_filter(),以及用于过滤侦听事件 的日志事件严重性ndb_mgm_listen_event()

枚举值

下表显示了可能的值以及说明:

表 3.4 类型 ndb_mgm_event_severity 值和描述

价值 描述
NDB_MGM_ILLEGAL_EVENT_SEVERITY 指定的事件严重性无效
NDB_MGM_EVENT_SEVERITY_ON 启用集群日志记录
NDB_MGM_EVENT_SEVERITY_DEBUG 仅用于 NDB Cluster 开发
NDB_MGM_EVENT_SEVERITY_INFO 信息性消息
NDB_MGM_EVENT_SEVERITY_WARNING 本身不是错误但可能需要特殊处理的情况
NDB_MGM_EVENT_SEVERITY_ERROR 应更正的非致命错误情况
NDB_MGM_EVENT_SEVERITY_CRITICAL 关键条件,例如设备错误或内存不足错误
NDB_MGM_EVENT_SEVERITY_ALERT 需要立即注意的情况,例如集群损坏
NDB_MGM_EVENT_SEVERITY_ALL 所有严重级别

有关这些函数如何使用此类型的信息, 请参阅 ndb_mgm_set_clusterlog_severity_filter()ndb_mgm_listen_event() 。

ndb_logevent_handle_error 类型

描述

此类型用于描述日志事件错误。

枚举值

下表显示了可能的值以及说明:

表 3.5 类型 ndb_logevent_handle_error 值和描述

价值 描述
NDB_LEH_NO_ERROR 没有错误
NDB_LEH_READ_ERROR 读取错误
NDB_LEH_MISSING_EVENT_SPECIFIER 日志事件规范无效、不完整或缺失
NDB_LEH_UNKNOWN_EVENT_TYPE 未知的日志事件类型
NDB_LEH_UNKNOWN_EVENT_VARIABLE 未知的日志事件变量
NDB_LEH_INTERNAL_ERROR 内部错误
NDB_LEH_CONNECTION_ERROR 连接错误,或与管理服务器失去连接

NDB_LEH_CONNECTION_ERROR在 NDB 7.4.13 中添加。(漏洞#19474782)

ndb_mgm_event_category 类型

描述

这些是The Ndb_logevent_type Type 中引用的日志事件类别 。它们也被 MGM API 函数 ndb_mgm_set_clusterlog_loglevel()ndb_mgm_listen_event().

枚举值

下表显示了可能的值以及说明:

表 3.6 类型 ndb_mgm_event_category 值和描述

价值 描述
NDB_MGM_ILLEGAL_EVENT_CATEGORY 无效的日志事件类别
NDB_MGM_EVENT_CATEGORY_STARTUP 记录启动期间发生的事件
NDB_MGM_EVENT_CATEGORY_SHUTDOWN 记录关机期间发生的事件
NDB_MGM_EVENT_CATEGORY_STATISTIC 统计日志事件
NDB_MGM_EVENT_CATEGORY_CHECKPOINT 记录与检查点相关的事件
NDB_MGM_EVENT_CATEGORY_NODE_RESTART 记录节点重启期间发生的事件
NDB_MGM_EVENT_CATEGORY_CONNECTION 记录与集群节点之间的连接相关的事件
NDB_MGM_EVENT_CATEGORY_BACKUP 记录与备份相关的事件
NDB_MGM_EVENT_CATEGORY_CONGESTION 记录与拥塞相关的事件
NDB_MGM_EVENT_CATEGORY_INFO 未分类的日志事件(严重级别INFO
NDB_MGM_EVENT_CATEGORY_ERROR 未分类的日志事件(严重级别WARNINGERRORCRITICALALERT

有关详细信息,请参阅ndb_mgm_set_clusterlog_loglevel()ndb_mgm_listen_event()