無

無

NdbEventOperation 代表資料庫事件。

下表列出此類別的公用方法以及每個方法的用途或用法

NdbEventOperation 定義一個列舉類型，即 State 類型。

清除最近與此事件操作相關聯的錯誤。

此方法已過時，並可能在未來版本中移除。從 NDB 8.4.0 開始，此方法不執行任何操作。

void clearError
    (
      void
    )

無.

無.

啟用 NdbEventOperation，使其可以開始接收事件。在 Ndb::nextEvent() 返回非 NULL 值後，可以檢索已變更的屬性值。

在呼叫 execute() 之前，必須先呼叫 getValue()、getPreValue()、getBlobValue() 或 getPreBlobValue() 中的一個。

在嘗試使用此方法之前，您應該已閱讀 Ndb::nextEvent() (已過時) 和 NdbEventOperation::getValue() 中提供的說明。另請參閱 第 2.3.16 節，「NdbEventOperation 類別」。

int execute
    (
      void
    )

無.

此方法在成功時返回 0，在失敗時返回 -1。

此方法用於代替 blob 屬性的 getValue()。此方法返回的 blob 控制代碼 (NdbBlob) 僅支援讀取操作。

若要取得 blob 屬性的先前值，請使用 getPreBlobHandle()。

NdbBlob* getBlobHandle
    (
      const char* name
    )

blob 屬性的 name。

指向 NdbBlob 物件的指標。

取得最近檢索的事件資料的 epoch。

此方法是在 NDB 7.4 中新增的，它取代了 getGCI()，後者現在已過時，並可能在未來的 NDB Cluster 版本中移除。

Uint64 getEpoch
  (
    void
  ) const

無.

epoch 號碼 (整數)。

此方法用於取得事件的類型 (TableEvent)。

此方法在 NDB 7.4 中已過時，並可能在未來版本中移除。在 NDB 7.4 及更新版本中，請改用 getEventType2()。

NdbDictionary::Event::TableEvent getEventType
    (
      void
    ) const

無.

TableEvent 值。

此方法用於取得事件的類型 (TableEvent)。

此方法是在 NDB 7.4 中新增的，它取代了 getEventType()，後者現在已過時，並可能在未來的 NDB Cluster 版本中移除。

getEventType2
    (
      void
    ) const

無.

TableEvent 值。

此方法會檢索最近檢索的事件的 GCI。

此方法在 NDB 7.4 中已過時，並可能在未來版本中移除。在 NDB 7.4 及更新版本中，請改用 getEpoch()。

Uint64 getGCI
    (
      void
    ) const

無.

最近檢索的事件的整體檢查點索引 (整數)。

此方法會檢索最新的 GCI。

此方法會返回最新的 epoch 號碼。

使用此方法取得的 GCI 不一定與事件相關聯。

此方法在 NDB 7.4 中已過時，並可能在未來版本中移除。在 NDB 7.4 及更新版本中，請改用 Ndb::getHighestQueuedEpoch()。

Uint64 getLatestGCI
    (
      void
    ) const

無.

最新整體檢查點的索引，整數。

此方法會檢索最近的錯誤。

const struct NdbError& getNdbError
    (
      void
    ) const

無.

指向 NdbError 結構的參考。

此函數與 getBlobHandle() 相同，不同之處在於它用於存取 blob 屬性的先前值。請參閱 NdbEventOperation::getBlobHandle()。

NdbBlob* getPreBlobHandle
  (
    const char* name
  )

blob 屬性的 name。

指向 NdbBlob 的指標。

此方法的執行方式與 getValue() 完全相同，不同之處在於它用於定義屬性先前值的檢索操作，而不是目前的值。

NdbRecAttr* getPreValue
    (
      const char* name,
      char*       value = 0
    )

此方法採用此處列出的兩個參數

用於保存屬性值的 NdbRecAttr 物件，或指示發生錯誤的 NULL 指標。

此方法會取得事件操作的目前狀態。

State getState
    (
      void
    )

無.

State 值。

此方法會定義屬性值的檢索。NDB API 會為要保存返回的屬性值的 NdbRecAttr 物件配置記憶體。

此方法不會從資料庫擷取屬性值，並且在呼叫 execute() 方法且 Ndb::nextEvent() 返回非 NULL 值之前，此方法返回的 NdbRecAttr 物件是無法讀取或列印的。

如果特定屬性未變更，則對應的 NdbRecAttr 將處於 UNDEFINED 狀態。可以使用 NdbRecAttr::isNULL() 進行檢查，在這種情況下，它會返回 -1。

getValue() 會檢索目前的值。請使用 getPreValue() 來檢索先前的值。

NdbRecAttr* getValue
    (
      const char* name,
      char*       value = 0
    )

此方法採用此處列出的兩個參數

用於保存屬性值的 NdbRecAttr 物件，或指示發生錯誤的 NULL 指標。

此方法用於判斷此事件操作是否發生錯誤。

此方法已過時，並可能在未來版本中移除。在 NDB 8.4 及更新版本中，它會返回一個常數。請改用 getEventType2() 來判斷事件類型。請參閱 Event::TableEvent。

int hasError
    (
      void
    ) const

無.

NDB 8.3 及更早版本：如果發生事件遺失，則此方法會返回 0；否則，會返回 1。

NDB 8.4 及更新版本：一律返回 0。

此方法用於判斷在節點故障後是否發生事件遺失。

此方法在 NDB 7.4 中已過時，並可能在未來版本中移除。在 NDB 7.4 及更新版本中，請改用 getEventType2() 來判斷事件類型是否為 TE_INCONSISTENT。請參閱 Event::TableEvent。

bool isConsistent
    (
      void
    ) const

無.

如果發生事件遺失，則此方法會返回 false；否則，會返回 true。

此方法用於判斷已取用的事件資料是否標示空的 epoch。

此方法是在 NDB 7.4 中新增的。

bool isEmptyEpoch
    (
      void
    )

無.

如果此 epoch 為空，則此方法會返回 true；否則，會返回 false。

此方法用於判斷已取用的事件資料是否標示空的 epoch。

此方法是在 NDB 7.4 中新增的。

bool isErrorEpoch
  (
    NdbDictionary::Event::TableEvent* error_type = 0
  )

如果此為錯誤 epoch，error_type 會包含對應於錯誤的 TableEvent 值。

如果此 epoch 發生錯誤，則此方法會返回 true；否則，會返回 false。

此方法用於判斷是否由於緩衝區溢位而發生事件遺失。

bool isOverrun
    (
      void
    ) const

無.

如果事件緩衝區已溢位，則此方法會返回 true，否則，會返回 false。

此方法用於設定合併事件旗標。有關事件合併的資訊，請參閱 Event::mergeEvents()。

合併事件旗標預設為 false。

void mergeEvents
    (
      bool flag
    )

一個布林值 flag。

無.

此類型描述事件操作的狀態。

State 值由 getState() 方法傳回。

下表顯示可能的值，以及說明。

此方法用於測試表格的分散性是否因 TE_ALTER 事件而改變。（請參閱 Event::TableEvent。）

bool tableFragmentationChanged
    (
      void
    ) const

無.

如果表格的分散性已變更，則傳回 true；否則，此方法會傳回 false。

使用此方法判斷表格 .FRM 檔案是否因 TE_ALTER 事件而變更。（請參閱 Event::TableEvent。）

bool tableFrmChanged
    (
      void
    ) const

無.

如果表格 .FRM 檔案已變更，則傳回 true；否則，此方法會傳回 false。

此方法測試表格名稱是否因 TE_ALTER 表格事件而變更。（請參閱 Event::TableEvent。）

bool tableNameChanged
    (
      void
    ) const

無.

如果表格的名稱已變更，則傳回 true；否則，此方法會傳回 false。

使用此方法檢查表格範圍分割區列表名稱是否因 TE_ALTER 事件而變更。

bool tableRangeListChanged
    (
      void
    ) const

無.

如果範圍或列表分割區名稱已變更，此方法會傳回 true；否則會傳回 false。