NdbOperation

NdbIndexScanOperation

该类NdbScanOperation表示事务中使用的扫描操作。此类继承自NdbOperation.

下表列出了该类的公共方法以及每个方法的用途或用途：

此类没有公共构造函数。要创建 的实例NdbScanOperation，必须使用 NdbTransaction::getNdbScanOperation() 方法。

此类定义了两个公共类型，列于此处：

调用此方法关闭扫描。使用此方法关闭扫描后，此扫描返回的行将不再可用。

请参阅 使用独占锁扫描，了解有关多个线程尝试使用独占锁执行相同扫描的信息，以及这如何影响关闭扫描。

void close
    (
      bool forceSend = false,
      bool releaseOp = false
    )

此方法采用此处列出的两个参数：

没有。

该方法用于删除当前元组。

const NdbOperation* deleteCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOpts = 0
    )

有关详细信息，请参阅第 2.3.22 节，“NdbRecord 接口”。

与 NdbRecord接口一起使用时，此方法采用此处列出的参数：

返回0成功或 -1失败。

获取NdbTransaction 此扫描的对象。

NdbTransaction* getNdbTransaction
    (
      void
    ) const

没有。

指向 NdbTransaction对象的指针。

此方法用于确定给定的扫描操作是否已被修剪为单个分区。对于使用 NdbRecord 定义的扫描，可以在执行扫描之前或之后调用此方法。对于未使用 定义 的扫描NdbRecord， getPruned()仅在执行扫描后才有效。

bool getPruned
    (
      void
    ) const

没有。

true如果扫描被修剪为单个表分区，则 返回。

此方法锁定当前元组。

可以通过此处显示的两种方式之一使用可选的单个参数调用此方法：

NdbOperation* lockCurrentTuple
    (
      void
    )

NdbOperation* lockCurrentTuple
    (
      NdbTransaction* lockTrans
    )

使用时，此方法还支持以下签名NdbRecord：

NdbOperation *lockCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0
    )

此方法还支持指定一个或多个 OperationOptions （使用时也是如此 NdbRecord）：

NdbOperation *lockCurrentTuple
    (
      NdbTransaction* takeOverTrans,
      const NdbRecord* record,
      char* row = 0,
      const unsigned char* mask = 0,
      const NdbOperation::OperationOptions* opts = 0,
      Uint32 sizeOfOptions = 0
    )

此方法采用单个可选参数——应该执行锁定的事务。如果省略，则交易是当前交易。

使用NdbRecord 接口时，此方法采用这些参数，如下表所述：

在 -style 扫描上调用NdbRecord扫描锁接管 NdbRecAttr是无效的，在 NdbRecAttr-style 扫描上调用 -style 扫描锁接管 也是无效的NdbRecord。

此方法返回指向 NdbOperation对象的指针，或 NULL.

此方法用于获取扫描事务中的下一个元组。在每次调用 之后 nextResult()，定义在 中的缓冲区和 NdbRecAttr对象都会NdbOperation::getValue() 使用扫描元组中的值进行更新。

当在nextResult()文件结束后执行时，NDB返回错误代码 4210（Ndb 发送的信息超过指定的长度）并且通过将额外的事务对象返回到正确的 TC 节点的空闲列表来释放它。

可以通过以下两种方式之一调用此方法。其中第一个显示在这里：

int nextResult
    (
      bool fetchAllowed = true,
      bool forceSend = false
    )

也可以使用此方法，如下所示：

int nextResult
    (
      const char*& outRow,
      bool fetchAllowed = true,
      bool forceSend = false
    )

此方法采用以下两个参数：

也可以使用以下三个参数调用此方法：

此方法返回以下 4 个整数值之一，解释如下表所示：

请参阅第 2.5.5 节，“NDB API 基本扫描示例”。

此方法用于执行扫描。

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

此方法采用此处列出的四个参数：

0成功 返回，-1失败返回。

使用此方法重新启动扫描而不更改其任何getValue()调用或搜索条件。

int restart
    (
      bool forceSend = false
    )

调用此方法并forceSend 设置为true以强制发送交易。

0成功时；-1失败时。

这种类型的值是与该 readTuples()方法一起使用的扫描标志。可以使用多个，在这种情况下，它们OR一起作为该方法的第二个参数。有关详细信息，请参阅 NdbScanOperation::readTuples()。

下表显示了可能的值以及说明：

NdbScanOperation

此数据结构用于将选项传递给类的 NdbRecord基 类scanTable() 和 scanIndex() 方法 NdbTransaction。通过在字段中设置相应的位来将每个选项类型标记为存在optionsPresent 。只有 optionsPresent字段中标记的选项类型需要有敏感数据。

ScanOptions 在操作定义时，所有数据都从结构（和任何对向结构）中 复制出来。如果不需要选项，则 NULL可以作为 ScanOptions指针传递。

构成该结构的元素如下表所示：

有关详细信息，请参阅第 2.3.22 节，“NdbRecord 接口”。

此方法用于更新当前元组。

本来，这个方法可以用一个调用。可选参数，采用此处显示的任一方式：

NdbOperation* updateCurrentTuple
    (
      void
    )


NdbOperation* updateCurrentTuple
    (
      NdbTransaction* updateTrans
    )

也可以在使用 NdbRecord扫描时使用此方法，如下所示：

NdbOperation* updateCurrentTuple
    (
      NdbTransaction*      takeOverTrans,
      const NdbRecord*     record,
      const char*          row,
      const unsigned char* mask = 0
    )

有关更多信息，请参阅第 2.3.22 节，“NdbRecord 接口”。

此方法采用单个可选参数——应该执行锁定的事务。如果省略，则交易是当前交易。

使用NdbRecord 接口时，此方法采用以下参数，如下表所述：

此方法返回一个 NdbOperation对象或 NULL。