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 的定义和使用方式与此方法的 2 参数版本相同。

成功返回 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。