MySQL NDB Cluster 8.1 手冊
MySQL NDB Cluster 8.0 手冊
NDB Cluster 內部手冊
本節提供有關 MGM API 所定義資料類型的資訊。
本節中描述的類型全部定義於 /storage/ndb/include/mgmapi/mgmapi.h 檔案中，但 Ndb_logevent_type、ndb_mgm_event_severity、ndb_mgm_logevent_handle_error 和 ndb_mgm_event_category 除外，它們定義於 /storage/ndb/include/mgmapi/ndb_logevent.h 中。
- 描述
此類型描述叢集節點的狀態。
- 列舉值
-
下表顯示了可能的值及其說明
表 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節點已連線
- 描述
此類型的值是 MGM API 函數可能產生的錯誤碼。這些錯誤碼可在第 3.5 節「MGM API 錯誤」中找到。
另請參閱 ndb_mgm_get_latest_error() 以取得更多資訊。
- 描述
-
這些是 MGM API 中可用的記錄事件類型，依事件類別分組。（請參閱 ndb_mgm_event_category 型別。）
這些記錄事件類型中的大多數都具有一個或多個對應的記錄事件訊息；這些訊息列於 NDB Cluster 記錄訊息中。
- 列舉值
-
下表顯示了可能的值及其說明
表 3.3 Ndb_logevent_type 型別的值、說明和事件類別
類型 描述 類別 NDB_LE_Connected節點已連線 NDB_MGM_EVENT_CATEGORY_CONNECTIONNDB_LE_Disconnected節點已中斷連線 NDB_MGM_EVENT_CATEGORY_CONNECTIONNDB_LE_CommunicationClosed與節點的通訊已關閉 NDB_MGM_EVENT_CATEGORY_CONNECTIONNDB_LE_CommunicationOpened已開始與節點通訊 NDB_MGM_EVENT_CATEGORY_CONNECTIONNDB_LE_ConnectedApiVersionAPI 節點使用的 API 版本；在 MySQL 伺服器 (SQL 節點) 的情況下，這與 SELECT VERSION()顯示的相同NDB_MGM_EVENT_CATEGORY_CONNECTIONNDB_LE_GlobalCheckpointStarted已開始全域檢查點 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_GlobalCheckpointCompleted已完成全域檢查點 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_LocalCheckpointStarted節點已開始本機檢查點 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_LocalCheckpointCompleted節點已完成本機檢查點 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_LCPStoppedInCalcKeepGci本機檢查點已中止，但保留了最後的全域檢查點 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_LCPFragmentCompleted已完成資料表片段的複製 NDB_MGM_EVENT_CATEGORY_CHECKPOINTNDB_LE_NDBStartStarted節點已開始啟動 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NDBStartCompleted節點已完成啟動程序 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_STTORRYRecieved節點收到 STTORRY訊號，表示正在讀取組態資料；請參閱組態讀取階段 (STTOR 階段 -1) 和 STTOR 階段 0 以取得更多資訊NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_StartPhaseCompleted已完成節點啟動階段 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_CM_REGCONF節點已收到 CM_REGCONF訊號；請參閱STTOR 階段 1 以取得更多資訊NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_CM_REGREF節點已收到 CM_REGREF訊號；請參閱STTOR 階段 1 以取得更多資訊NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_FIND_NEIGHBOURS節點已在叢集中發現其相鄰節點 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NDBStopStarted節點正在開始關閉 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NDBStopCompleted節點關閉已完成 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NDBStopForced正在強制關閉節點（通常表示叢集中出現嚴重問題） NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NDBStopAborted已開始關閉，但被迫繼續執行；例如，當在管理用戶端中對節點發出 STOP命令時會發生這種情況，如此一來，如果關閉該節點，叢集將無法保持所有資料可用NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_StartREDOLog已開始重做記錄 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_StartLog已開始記錄 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_UNDORecordsExecuted節點已讀取並執行重做記錄中的所有記錄 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_StartReport節點正在發出啟動報告 NDB_MGM_EVENT_CATEGORY_STARTUPNDB_LE_NR_CopyDict節點正在複製資料字典 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NR_CopyDistr節點正在複製資料散佈資訊 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NR_CopyFragsStarted節點正在複製資料表片段 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NR_CopyFragDone節點已完成複製資料表片段 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NR_CopyFragsCompleted節點已完成複製所有必要的資料表片段 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NodeFailCompleted已通知所有（剩餘）節點資料節點發生故障 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_NODE_FAILREP資料節點發生故障 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_ArbitState此事件用於報告叢集中仲裁的目前狀態 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_ArbitResult此事件用於報告節點仲裁的結果 NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_GCP_TakeoverStarted節點正在嘗試成為主要節點（以承擔 GCP 的責任） NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_GCP_TakeoverCompleted節點已成為主要節點（並承擔 GCP 的責任） NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_LCP_TakeoverStarted節點正在嘗試成為主要節點（以承擔 LCP 的責任） NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_LCP_TakeoverCompleted節點已成為主要節點（並承擔 LCP 的責任） NDB_MGM_EVENT_CATEGORY_NODE_RESTARTNDB_LE_TransReportCounters這表示交易活動的報告，大約每 10 秒鐘提供一次 NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_OperationReportCounters表示此節點執行的操作數量的報告（也大約每 10 秒鐘提供一次） NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_TableCreated已建立新資料表 NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_UndoLogBlocked由於記錄緩衝區即將溢位，因此還原記錄已封鎖 NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_JobStatistic... NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_SendBytesStatistic表示此節點每次傳送操作傳輸的平均位元組數的報告 NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_ReceiveBytesStatistic表示每次傳送到此節點的傳送操作收到的平均位元組數的報告 NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_MemoryUsage已對此節點發出 DUMP 1000命令，並且它反過來報告其記憶體用量NDB_MGM_EVENT_CATEGORY_STATISTICNDB_LE_TransporterError傳輸器發生錯誤；請參閱NDB 傳輸器錯誤，以取得傳輸器錯誤代碼和訊息。 NDB_MGM_EVENT_CATEGORY_ERRORNDB_LE_TransporterWarning傳輸器中可能發生問題；請參閱NDB 傳輸器錯誤，以取得傳輸器錯誤代碼和訊息。 NDB_MGM_EVENT_CATEGORY_ERRORNDB_LE_MissedHeartbeat表示資料節點錯過另一個資料節點的預期心跳。 NDB_MGM_EVENT_CATEGORY_ERRORNDB_LE_DeadDueToHeartbeat一個資料節點連續錯過來自另一個資料節點的至少 3 個心跳，並報告它無法再與該資料節點通訊。 NDB_MGM_EVENT_CATEGORY_ERRORNDB_LE_WarningEvent表示警告訊息。 NDB_MGM_EVENT_CATEGORY_ERRORNDB_LE_SentHeartbeat已傳送節點心跳。 NDB_MGM_EVENT_CATEGORY_INFONDB_LE_CreateLogBytes... NDB_MGM_EVENT_CATEGORY_INFONDB_LE_InfoEvent表示資訊性訊息。 NDB_MGM_EVENT_CATEGORY_INFONDB_LE_SingleUser叢集已進入或退出單一使用者模式。 NDB_MGM_EVENT_CATEGORY_INFONDB_LE_EventBufferStatus此類型的事件表示事件緩衝區可能過度使用。 NDB_MGM_EVENT_CATEGORY_INFONDB_LE_EventBufferStatus2NDB_LE_EventBufferStatus的延伸，提供改進的事件緩衝區狀態報告；在 NDB 7.5 中新增。NDB_MGM_EVENT_CATEGORY_INFONDB_LE_EventBufferStatus3NDB_LE_EventBufferStatus的延伸，使用 64 位元值表示總位元組數、最大位元組數和已配置的位元組數；在 NDB 7.5.23、7.6.19 和 8.0.26 中新增。NDB_MGM_EVENT_CATEGORY_INFONDB_LE_BackupStarted已啟動備份。 NDB_MGM_EVENT_CATEGORY_BACKUPNDB_LE_BackupFailedToStart備份啟動失敗。 NDB_MGM_EVENT_CATEGORY_BACKUPNDB_LE_BackupCompleted備份已成功完成。 NDB_MGM_EVENT_CATEGORY_BACKUPNDB_LE_BackupAborted進行中的備份已由使用者終止。 NDB_MGM_EVENT_CATEGORY_BACKUP
- 描述
這些是日誌事件嚴重性，用於透過
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 叢集開發。 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()。
- 描述
此類型用於描述日誌事件錯誤。
- 列舉值
-
下表顯示了可能的值及其說明
表 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_logevent_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未分類的日誌事件（嚴重性層級為 WARNING、ERROR、CRITICAL或ALERT）。
如需更多資訊，請參閱ndb_mgm_set_clusterlog_loglevel() 和 ndb_mgm_listen_event()。