NdbScanOperation

無

NdbIndexScanOperation 類別代表使用排序索引的掃描作業。此類別繼承自 NdbScanOperation 與 NdbOperation。

NdbIndexScanOperation 僅適用於排序索引；若要使用唯一雜湊索引，請使用 NdbIndexOperation。

如需有關使用 NdbIndexScanOperation 的詳細資訊，請參閱 第 1.4.2.3.3 節，「掃描作業」，以及 第 1.4.2.3.4 節，「使用掃描來更新或刪除列」。

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

NdbIndexScanOperation 類別定義一個公用類型 BoundType。

此類別也定義一個 IndexBound 資料結構，供使用 NdbRecord 的作業使用。

此類型用於描述排序的鍵界限。

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

剛才顯示的數值是「安全」的；也就是說，它們在 API 中是固定的，因此可以明確計算和使用。

此方法用於標記界限的結束；當批次處理索引讀取時（也就是說，當使用多個範圍時），會使用此方法。

int end_of_bound
    (
      Uint32 range_no
    )

發生界限的範圍編號。

0 表示成功；-1 表示失敗。

此方法用於檢查掃描是否為遞減。

bool getDescending
    (
      void
    ) const

無.

如果掃描依遞減順序排序，此方法會傳回 true；否則，會傳回 false。

此方法會傳回目前列的範圍編號。

int get_range_no
    (
      void
    )

無.

範圍編號（一個整數）。

此方法用於檢查掃描是否已排序。

bool getSorted
    (
      void
    ) const

無.

如果掃描已排序，則為 true，否則為 false。

NdbIndexScanOperation

IndexBound 是一個結構，用於描述 NdbRecord 掃描的索引掃描界限。

下表顯示成員名稱、類型與說明

此方法用於使用排序索引讀取元組。

virtual int readTuples
    (
      LockMode mode = LM_Read,
      Uint32   flags = 0,
      Uint32   parallel = 0,
      Uint32   batch = 0

    )

readTuples() 方法採用此處列出的三個參數

一個整數：0 表示成功；-1 表示失敗。

重設界限，並將操作放入下一次呼叫 NdbTransaction::execute() 時傳送的清單中。

int reset_bounds
    (
      bool forceSend = false
    )

設定 forceSend 為 true，以強制立即傳送操作。

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

此方法會定義範圍掃描中使用的索引鍵的界限，並為使用 NdbRecord 定義的索引掃描設定界限。

當與 NdbRecord 一起使用時，此方法會被呼叫，以將範圍新增至已使用呼叫 NdbTransaction::scanIndex() 定義的索引掃描操作中。若要新增多個範圍，索引掃描操作必須已設定 SF_MultiRange 旗標。(請參閱 NdbScanOperation::ScanFlag。)

如果使用多次呼叫 setBound() 定義多個編號範圍，且掃描已排序，則每個範圍的範圍編號必須大於先前定義的範圍的範圍編號。

int setBound
    (
      const NdbRecord* keyRecord,
      const IndexBound& bound
    )

當與 NdbRecord 一起使用時，此方法會採用 2 個參數，在此列出

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

int setBound
    (
      const NdbRecord* keyRecord,
      const IndexBound& bound,
      const Ndb::PartitionSpec* partInfo,
      Uint32 sizeOfPartInfo = 0
    )

此方法也可以使用以下四個參數進行叫用

keyRecord 和 bound 的定義和使用方式與此方法的雙參數版本相同。

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

每個索引鍵都可以有下限、上限或兩者。將索引鍵設定為某個值會定義上限和下限。可以依照任何順序定義界限。衝突的定義會產生錯誤。

必須在索引鍵的初始序列上設定界限，且除了可能最後一個界限之外，所有界限都必須是非嚴格的。例如，這表示 “a >= 2 AND b > 3” 是允許的，但 “a > 2 AND b >= 3” 則否。

掃描目前可能會傳回不滿足界限的元組。例如，<= 2 && b <= 3 不僅會掃描索引到 (a=2, b=3)，也會傳回任何 (a=1, b=4)。

在設定基於相等性的界限時，最好使用 BoundEQ，而不是等效的配對 BoundLE 和 BoundGE。當資料表分割區索引鍵是索引鍵的前置字元時，尤其如此。

NULL 被視為小於任何非 NULL 值，且等於另一個 NULL 值。若要使用 NULL 執行比較，請使用空指標 (0) 呼叫 setBound()。

索引也會儲存全部為 NULL 的索引鍵，且使用空的界限集執行索引掃描會傳回資料表中的所有元組。

使用 “舊版” API 時，可以使用兩種方式呼叫此方法。這兩種方式都會使用界限類型和值；第一種方式也會使用界限的名稱，如下所示

int setBound
    (
      const char* name,
      int         type,
      const void* value
    )

在 “舊版” API 下叫用此方法的第二種方式是使用界限的 ID 而非名稱，如下所示

int setBound
    (
      Uint32      id,
      int         type,
      const void* value
    )

此方法採用 3 個參數

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