無

無

交易在 NDB API 中由 NdbTransaction 物件表示，該物件屬於 Ndb 物件，並使用 Ndb::startTransaction() 建立。交易包含由 NdbOperation 類別，或其子類別之一 — NdbScanOperation、NdbIndexOperation 或 NdbIndexScanOperation 所表示的作業清單。每個作業都只存取一個資料表。

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

方法 readTuple()、insertTuple()、updateTuple()、writeTuple()、deleteTuple()、scanTable() 和 scanIndex() 需要使用 NdbRecord。

NdbTransaction 定義了 2 個公用類型，如下表所示

此方法會關閉交易。它等同於呼叫 Ndb::closeTransaction()。

如果交易尚未提交，則在呼叫此方法時會中止交易。請參閱 Ndb::startTransaction()。

void close
    (
      void
    )

無.

無.

此方法會取得交易的提交狀態。

CommitStatusType commitStatus
    (
      void
    )

無.

交易的提交狀態，類型為 CommitStatusType 的值。

此類型用於描述交易的提交狀態。

下表顯示了可能的值以及描述

使用 NdbRecord 刪除元組。

const NdbOperation* deleteTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* result_rec,
      char* result_row,
      const unsigned char* result_mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

此方法採用下列參數

指向代表此寫入操作的 NdbOperation 的 const 指標。如有必要，可以檢查操作是否有錯誤。

此類型設定交易的執行類型；也就是說，它應該執行、執行並提交，還是中止。它用作 execute() 方法的參數。（請參閱 NdbTransaction::execute()。）

下表顯示了可能的值以及描述

此方法用於執行交易。

int execute
    (
      ExecType execType,
      NdbOperation::AbortOption abortOption = NdbOperation::DefaultAbortOption,
      int force = 0
    )

execute() 方法採用這裡列出的三個參數

成功時傳回 0，失敗時傳回 -1。交易未中止的事實並不一定表示每個操作都成功；您必須單獨檢查每個操作是否有錯誤。

如果仍有任何尚未執行的給定類型的 blob 部分操作，則此方法會以等於 NoCommit 的 ExecType 來執行交易。

int executePendingBlobOps
  (
    Uint8 flags = 0xFF
  )

flags 參數是位元運算 OR 的結果，等於 1 << optype，其中 optype 是一個 NdbOperation::Type。預設值對應於 NdbOperation::Type::PrimaryKeyAccess。

成功時傳回 0，失敗時傳回 -1。交易未中止的事實並不一定表示每個操作都成功；您必須單獨檢查每個操作是否有錯誤。

此方法會擷取交易的全域檢查點 ID (GCI)。

每個已提交的交易都屬於一個 GCI。當發生全域檢查點時，已提交交易的記錄會儲存在磁碟上。

透過比較交易的 GCI 與重新啟動的 NDB Cluster 中還原的最新 GCI 值，您可以判斷是否已還原該交易。

此方法無法判斷具有此 GCI 的全域檢查點是否已儲存到磁碟上。

掃描交易的 GCI 是未定義的，因為掃描交易中不會執行任何更新。

在以 ExecType::Commit 呼叫 execute() 之前，沒有可用的 GCI。

int getGCI
    (
      void
    )

無.

交易的 GCI，如果沒有可用的，則為 -1。

取得 blob 讀取操作的目前批次大小 (以位元組為單位)。當在給定交易中要讀取的 blob 資料量超過此值時，將執行該交易的所有待處理 blob 讀取操作。

Uint32 getMaxPendingBlobReadBytes
    (
      void
    ) const

無.

目前的 blob 讀取批次大小，以位元組為單位。如需更多資訊，請參閱 NdbTransaction::setMaxPendingBlobReadBytes()。

取得 blob 寫入操作的目前批次大小 (以位元組為單位)。當在給定交易中要寫入的 blob 資料量超過此值時，將執行該交易的所有待處理 blob 寫入操作。

Uint32 getMaxPendingBlobWriteBytes
    (
      void
    ) const

無.

目前的 blob 寫入批次大小，以位元組為單位。如需更多資訊，請參閱 NdbTransaction::setMaxPendingBlobWriteBytes()。

此方法用於取得最近的錯誤 (NdbError)。

const NdbError& getNdbError
    (
      void
    ) const

無.

對 NdbError 物件的參考。

此方法會傳回發生最近錯誤的行號。

int getNdbErrorLine
    (
      void
    )

無.

最近錯誤的行號。

此方法會擷取造成錯誤的操作。

若要取得有關實際錯誤的更多資訊，請使用 getNdbErrorOperation() 所傳回的 NdbOperation 物件的 NdbOperation::getNdbError() 方法。

NdbOperation* getNdbErrorOperation
    (
      void
    )

無.

指向 NdbOperation 的指標。

此方法用於建立與給定表格關聯的 NdbIndexOperation。

相同交易中的所有索引操作都必須使用此方法初始化。操作必須在執行之前定義。

NdbIndexOperation* getNdbIndexOperation
    (
      const NdbDictionary::Index* index
    )

要執行操作的 Index 物件。

指向新的 NdbIndexOperation 的指標。

此方法用於建立與給定表格關聯的 NdbIndexScanOperation。

相同交易中的所有索引掃描操作都必須使用此方法初始化。操作必須在執行之前定義。

NdbIndexScanOperation* getNdbIndexScanOperation
    (
      const NdbDictionary::Index* index
    )

要執行操作的 Index 物件。

指向新的 NdbIndexScanOperation 的指標。

此方法用於建立與給定表格關聯的 NdbOperation。

相同交易中的所有操作都必須使用此方法初始化。操作必須在執行之前定義。

NdbOperation* getNdbOperation
    (
      const NdbDictionary::Table* table
    )

要執行操作的 Table 物件。

指向新的 NdbOperation 的指標。

此方法用於建立與給定表格關聯的 NdbScanOperation。

相同交易中的所有掃描操作都必須使用此方法初始化。操作必須在執行之前定義。

NdbScanOperation* getNdbScanOperation
    (
      const NdbDictionary::Table* table
    )

要執行操作的 Table 物件。

指向新的 NdbScanOperation 的指標。

此方法用於擷取交易的已完成操作。它通常用於擷取屬於給定交易的所有操作，以檢查錯誤。

NdbTransaction::getNextCompletedOperation(NULL) 會傳回交易的第一個 NdbOperation 物件；NdbTransaction::getNextCompletedOperation(myOp) 會傳回在 NdbOperation myOp 之後定義的 NdbOperation 物件。

此方法僅應在交易執行之後，但在交易關閉之前使用。

const NdbOperation* getNextCompletedOperation
    (
      const NdbOperation* op
    ) const

此方法需要一個參數 op，它是一個操作 (NdbOperation 物件)，或 NULL。

在 op 之後的操作，如果使用 NULL 呼叫 getNextCompletedOperation()，則為為交易定義的第一個操作。

此方法用於取得交易 ID。

Uint64 getTransactionId
    (
      void
    )

無.

交易 ID，作為一個不帶正負號的 64 位元整數。

使用 NdbRecord 插入元組。

const NdbOperation* insertTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

const NdbOperation* insertTuple
    (
      const NdbRecord* combined_rec,
      const char* combined_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

insertTuple() 採用下列參數

指向表示此插入操作的 NdbOperation 的 const 指標。

此方法使用 NdbRecord 物件讀取元組。

const NdbOperation* readTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* result_rec,
      char* result_row,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

此方法採用下列參數

指向代表此讀取操作的 NdbOperation 的指標（可用於檢查錯誤）。

此方法會更新交易的逾時計數器，因此可避免因交易逾時而中止。

不建議鎖定記錄並長時間維持鎖定，因為這會影響其他交易。

int refresh
    (
      void
    )

無.

成功時傳回 0，失敗時傳回 -1。

當不再需要鎖定控制代碼時，此方法用於釋放鎖定控制代碼（請參閱 NdbOperation::getLockHandle）。對於 NdbRecord 主索引鍵讀取操作，必須在執行相關聯的讀取操作後才能呼叫此方法。

當關閉交易時，會釋放與指定交易相關聯的所有鎖定控制代碼。

int releaseLockHandle
    (
      const NdbLockHandle* lockHandle
    )

要釋放的 NdbLockHandle 物件。

成功時傳回 0。

對資料表執行索引範圍掃描，並可選擇是否排序。

NdbIndexScanOperation* scanIndex
    (
      const NdbRecord* key_record,
      const NdbRecord* result_record,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      const NdbIndexScanOperation::IndexBound* bound = 0,
      const NdbScanOperation::ScanOptions* options = 0,
      Uint32 sizeOfOptions = 0
    )

目前的 NdbIndexScanOperation，可用於錯誤檢查。

此方法會使用 NdbRecord 物件來讀取欄資料，以執行資料表掃描。

NdbScanOperation* scanTable
    (
      const NdbRecord* result_record,
      NdbOperation::LockMode lock_mode = NdbOperation::LM_Read,
      const unsigned char* result_mask = 0,
      Uint32 scan_flags = 0,
      Uint32 parallel = 0,
      Uint32 batch = 0
    )

scanTable() 方法採用下列參數

指向代表此掃描的 NdbScanOperation 的指標。如有必要，可以檢查操作是否有錯誤。

設定 blob 讀取操作的批次大小（以位元組為單位）。當給定交易中要讀取的 blob 資料量超過此數量時，將會執行所有交易的擱置 blob 讀取操作。

void setMaxPendingBlobReadBytes
    (
      Uint32 bytes
    )

批次大小，以 bytes 的數量表示。使用 0 會停用 blob 讀取批次處理，此為預設行為（為了回溯相容性）。

無.

設定 blob 寫入操作的批次大小（以位元組為單位）。當給定交易中要寫入的 blob 資料量超過此數量時，將會執行所有交易的擱置 blob 寫入操作。

void setMaxPendingBlobWriteBytes
    (
      Uint32 bytes
    )

批次大小，以 bytes 的數量表示。使用 0 會停用 blob 寫入批次處理，此為預設行為（為了回溯相容性）。

無.

當使用多個 Ndb_cluster_connection 物件時，啟用或停用結構描述物件所有權檢查。啟用此檢查時，會檢查此交易使用的物件，以確定它們屬於此連線擁有的 NdbDictionary。這是透過從連線擷取相同名稱的結構描述物件，並將這些物件與傳遞給交易的結構描述物件進行比較來完成的。如果它們不相符，則會傳回錯誤。

此方法可用於偵錯用途。(錯誤 #19875977) 您應注意，啟用此檢查會產生效能損耗，因此您應避免在生產環境中執行此操作。

void setSchemaObjOwnerChecks
    (
      bool runChecks
    )

單一參數 runChecks。使用 true 啟用所有權檢查，使用 false 停用所有權檢查。

無.

此方法會在目前的交易上建立解除鎖定操作；執行時，解除鎖定操作會移除方法傳遞的 NdbLockHandle 參考的鎖定（請參閱 NdbOperation::getLockHandle）。

const NdbOperation* unlock
    (
      const NdbLockHandle* lockHandle,
      NdbOperation::AbortOption ao = NdbOperation::DefaultAbortOption
    )

指向鎖定控制代碼的指標；此外，可選擇性地傳遞 AbortOption 值 ao。

如果解除鎖定操作失敗 (例如，因為該列已被解除鎖定)，AbortOption 會指定如何處理這種情況，預設情況下，錯誤會導致交易中止。

指向 NdbOperation 的指標 (已建立的解除鎖定操作)。

使用 NdbRecord 物件更新元組。

const NdbOperation* updateTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

updateTuple() 接受以下參數

代表此操作的 NdbOperation (可用於檢查錯誤)。

此方法與 NdbRecord 一起使用，以寫入資料元組。

const NdbOperation* writeTuple
    (
      const NdbRecord* key_rec,
      const char* key_row,
      const NdbRecord* attr_rec,
      const char* attr_row,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

此方法採用下列參數

指向代表此寫入操作的 NdbOperation 的 const 指標。如有必要，可以檢查操作是否有錯誤。