没有任何

NdbIndexOperation, NdbScanOperation

NdbOperation表示 “通用”数据操作。它的子类代表更具体的操作类型。有关操作类型及其相应子类的列表， 请参阅 NdbOperation::TypeNdbOperation。

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

此类没有公共构造函数。要创建 的实例NdbOperation，您必须使用 NdbTransaction::getNdbOperation()。

该类NdbOperation定义了三种公共类型，如下表所示：

此类型用于确定失败的操作是否应强制中止事务。它用作该execute() 方法的参数——有关更多信息，请参阅 NdbTransaction::execute()。

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

添加两个寄存器的内容；将结果存储在第三个寄存器中。

int add_reg
    (
      Uint32 RegSource1, 
      Uint32 RegSource2, 
      Uint32 RegDest
    )

0 成功，否则 -1。

如果指定的列是 ，则分支到解释程序中的标签NULL。

int branch_col_eq_null
    (
      Uint32 ColId, 
      Uint32 Label
    )

0 成功，否则 -1。

如果指定的列不是 ，则分支到解释程序中的标签NULL。

int branch_col_ne_null
    (
      Uint32 ColId, 
      Uint32 Label
    )

没有任何

如果给定值等于指定列的值，则分支到解释程序中的标签。

int branch_col_eq
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，-1 否则。

如果给定值不等于指定列的值，则分支到解释程序中的标签。

int branch_col_ne
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，否则 -1。

如果给定值小于列值，则分支到解释程序中的标签。

int branch_col_lt
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，否则 -1。

如果给定值小于或等于列值，则分支到解释程序中的标签。

int branch_col_le
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

成功时，0；否则，-1。

如果给定值大于列值，则分支到解释程序中的标签。

int branch_col_gt
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，-1 否则。

如果给定值大于或等于列值，则分支到解释程序中的标签。

int branch_col_ge
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 如果成功，否则 -1。

如果列值与通配符模式匹配，则分支。此方法和 branch_col_notlike() 每个方法都支持 MySQL LIKE运算符使用的通配符： %用于 0 个或多个字符的任何字符串，以及_任何单个字符。

列的类型必须是 CHAR、 VARCHAR、 BINARY或 之一VARBINARY。

int branch_col_like
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，否则 -1。

如果列值与给定的通配符模式不匹配，则分支。此方法和 每个方法都支持与 MySQL运算符branch_col_like() 相同的通配符%（0 个或多个字符）和（任何一个字符） 。 _LIKE

列的类型必须是 CHAR、 VARCHAR、 BINARY或 之一VARBINARY。

int branch_col_notlike
    (
      Uint32 ColId, 
      const void* val, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，-1 否则。

如果具有位掩码的逻辑按 AND位列的值等于位掩码，则分支。

另请参阅 按位逻辑比较。

int branch_col_and_mask_eq_mask
    (
      Uint32 ColId, 
      const void* mask, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，-1 否则。

如果具有位掩码的逻辑按 AND位列的值不等于位掩码，则分支。

另请参阅 按位逻辑比较。

int branch_col_and_mask_ne_mask
    (
      Uint32 ColId, 
      const void* mask, 
      Uint32 len,
      bool,
      Uint32 Label
    )

成功 0，否则 -1。

如果具有位掩码的逻辑按 AND位列的值等于 0，则分支。

另请参阅 按位逻辑比较。

int branch_col_and_mask_eq_zero
    (
      Uint32 ColId, 
      const void* mask, 
      Uint32 len,
      bool,
      Uint32 Label
    )

0 成功，-1 否则。

如果具有位掩码的逻辑按 AND位列的值不等于 0，则分支。

另请参阅 按位逻辑比较。

int branch_col_and_mask_ne_zero
    (
      Uint32 ColId, 
      const void* mask, 
      Uint32 len,
      bool,
      Uint32 Label
    )

成功返回 0，否则返回 -1。

在解释程序中定义搜索条件。将右侧寄存器值与左侧进行比较；如果 RH 值大于或等于 LH 值，则分支到标签。

int branch_ge
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，-1 否则。

在解释程序中定义搜索条件。将右侧寄存器值与左侧进行比较；如果 RH 值大于 LH 值，则分支到标签。

int branch_gt
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，-1 否则。

在解释程序中定义搜索条件。将右侧寄存器值与左侧进行比较；如果 RH 值小于 LH 值，则分支到标签。

int branch_le
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，-1 否则。

在解释程序中定义搜索条件。将右侧寄存器值与左侧进行比较；如果 RH 值小于或等于 LH 值，则分支到标签。

int branch_lt
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，-1 否则。

当两个寄存器值相等时，分支到解释程序中的标签。

int branch_eq
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，-1 否则。

当两个寄存器值不相等时，在解释程序中分支到标签。

int branch_eq
    (
      Uint32 RegLvalue, 
      Uint32 RegRvalue, 
      Uint32 Label
    )

0 成功，否则 -1。

如果寄存器值不是 ，则分支到已插入程序中的标签NULL。

int branch_ne_null
    (
      Uint32 RegLvalue, 
      Uint32 Label
    )

成功返回0；否则，返回 -1。

如果寄存器值为 ，则分支到插入程序中的标签NULL。

int branch_ne_null
    (
      Uint32 RegLvalue, 
      Uint32 Label
    )

成功时，0；否则，-1。

跳转到一个被插入的程序中的标签。

int branch_label
    (
      Uint32 Label
    )

0 如果成功；否则，-1。

在一个被解释的程序中调用一个子程序。

int call_sub
    (
      Uint32 Subroutine
    )

成功则返回0；否则，返回 -1。

在解释操作中定义跳转标签。标签自动从 0 开始编号。

int def_label
    (
      int labelNumber
    )

labelNumber成功，-1 否则。

在解释程序中定义一个子程序。

int def_subroutine
    (
      int SubroutineNumber
    )

0 成功，-1 否则。

此方法将 定义 NdbOperation为一个 DELETE操作。NdbTransaction::execute() 调用 该方法时 ，该操作会从表中删除一个元组。

virtual int deleteTuple
    (
      void
    )

没有。

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

此方法定义具有相等性的搜索条件。如果属性具有给定值，则条件为真。要在多个属性上设置搜索条件，请多次调用equal(); 在这种情况下，必须满足所有这些条件才能选择元组。

如果属性是固定大小，则其值必须包括所有字节。特别是一个Char值必须是原生空间填充的。如果该属性的大小可变，则其值必须以 1 或 2 个小端长度字节开头（如果其类型为 ，则为 2 Long*）。

使用 时insertTuple()，您还可以使用 定义搜索键setValue()。请参阅NdbOperation::setValue()。

有 10 个版本equal()，每个版本的参数略有不同。所有这些都显示在这里：

int  equal
    (
      const char* name,
      const char* value
    )

int  equal
    (
      const char* name,
      Int32       value
    )

int  equal
    (
      const char* name,
      Uint32      value
    )

int  equal
    (
      const char* name,
      Int64       value
    )

int  equal
    (
      const char* name,
      Uint64      value
    )

int  equal
    (
      Uint32      id,
      const char* value
    )

int  equal
    (
      Uint32 id,
      Int32  value
    )

int  equal
    (
      Uint32 id,
      Uint32 value
    )

int  equal
    (
      Uint32 id,
      Int64  value
    )

int  equal
    (
      Uint32 id,
      Uint64 value
    )

该方法需要两个参数：

-1发生错误时 返回。

此方法用于代替 getValue()或 setValue()用于 blob 属性。它创建一个 blob 句柄（NdbBlob对象）。使用相同参数的第二次调用返回先前创建的句柄。手柄与操作联动，自动维护。

此方法有两种形式，具体取决于它是使用 blob 属性的名称还是 ID 调用的：

virtual NdbBlob* getBlobHandle
    (
      const char* name
    )

或者

virtual NdbBlob* getBlobHandle
    (
      Uint32 id
    )

此方法采用单个参数，该参数可以是以下之一：

无论使用何种参数类型，此方法都会返回一个指向 的实例的指针 NdbBlob。

返回指向当前操作的锁句柄的指针。与 一起使用时 NdbRecord，必须首先使用 OO_LOCKHANDLE操作选项请求锁定句柄。对于其他操作，可以单独使用此方法。在任何情况下， NdbLockHandle该方法返回的对象在操作执行之前都不能使用。

const NdbLockHandle* getLockHandle
    (
      void
    ) const

或者

const NdbLockHandle* getLockHandle
    (
      void
    )

没有。

指向 方法 和 NdbLockHandle可以使用的 的指针。 NdbTransactionunlock()releaseLockHandle()

此方法获取操作的锁定模式。

LockMode getLockMode
    (
      void
    ) const

没有。

一个LockMode值。请参阅 NdbOperation::LockMode。

此方法获取最近的错误（一个 NdbError对象）。

const NdbError& getNdbError
    (
      void
    ) const

没有。

一个NdbError对象。

此方法检索最近发生错误的方法编号。

int getNdbErrorLine
    (
      void
    ) const

没有。

方法编号（整数）。

此方法用于检索与操作关联的表对象。

const NdbDictionary::Table* getTable
    (
      void
    ) const

没有。

指向 的实例的指针 Table。

此方法检索用于操作的表的名称。

const char* getTableName
    (
      void
    ) const

没有。

表的名称。

获取NdbTransaction 此操作的对象。

virtual NdbTransaction* getNdbTransaction
    (
      void
    ) const

没有。

指向 NdbTransaction对象的指针。

此方法用于检索此操作的访问类型。

Type getType
    (
      void
    ) const

没有。

一个Type值。

此方法准备检索属性值。NdbRecAttrNDB API为稍后用于获取属性值的对象分配内存 。这可以通过使用许多 NdbRecAttr访问器方法中的一种来完成，要使用的确切方法取决于属性的数据类型。（这包括通用 NdbRecAttr::aRef()方法，它将数据检索为char*，而不管其实际类型如何。您应该知道这不是类型安全的，需要用户进行显式转换。）

该方法不从数据库中获取属性值；此方法返回的 NdbRecAttr对象在调用 之前不可读或不可打印 NdbTransaction::execute()。

如果特定属性未更改，则相应 NdbRecAttr的具有 state UNDEFINED。这可以通过使用来检查 NdbRecAttr::isNULL()，在这种情况下返回-1。

请参阅NdbTransaction::execute()和 NdbRecAttr::isNULL()。

此方法有三个版本，每个版本都有不同的参数：

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

NdbRecAttr* getValue
    (
      Uint32 id,
      char*  value = 0
    )

NdbRecAttr* getValue
    (
      const NdbDictionary::Column* col,
      char*                        value = 0
    )

此方法的所有三种形式都有两个参数，第二个参数是可选的（默认为 0）。它们仅在第一个参数的类型方面有所不同，可以是以下任何一个：

在所有这三种情况下，第二个参数都是一个字符缓冲区，其中NULL返回一个非属性值。如果属性是 NULL，它是否仅存储在 NdbRecAttr此方法返回的对象中。

如果value在 getValue()方法调用中未指定 no，或者如果将 0 作为值传递，则该 NdbRecAttr对象提供内存管理以存储接收到的数据。如果接收到的数据的最大大小大于一个小的固定大小，malloc()则用于存储它：对于小的大小，提供一个小的、固定的内部缓冲区（范围为 32 字节）。该存储由 NdbRecAttr实例管理；它在操作被释放时被释放，例如在事务关闭时；在释放内存之前，您希望保留的任何写入此处的数据都应复制到其他地方。

如果为 传递一个非零指针 value，则假定 this 指向足以容纳列最大值的内存部分；任何返回的数据都写入该位置。指针应至少对齐 32 位。

使用此方法不能使用索引列代替表列。在表列不可用的情况下，您可以使用通过 获得的属性名称 getName()来代替。

指向NdbRecAttr 保存属性值的对象的 NULL指针，或指示错误的指针。

NdbOperation

此结构用于指定要作为操作的一部分获取的额外值NdbRecord 。

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

无法使用 指定 Blob 读取 GetValueSpec。

向属性添加值的解释程序指令。属性可以按名称或 ID 指定。因此，此方法有四个版本，参数略有不同，如 Signature下所示。

该指令使用寄存器 6 和 7，并在其操作过程中覆盖这些寄存器。

对于扫描和NdbRecord 操作，请改用 NdbInterpretedCode 界面。

int incValue
    (
      const char* anAttrName, 
      Uint32 aValue
    )

int incValue
    (
      const char* anAttrName, 
      Uint64 aValue
    )

int incValue
    (
      Uint32 anAttrId, 
      Uint32 aValue
    )

int incValue
    (
      Uint32 anAttrId, 
      Uint64 aValue
    )

0 成功，-1 否则。

此方法将 定义 NdbOperation为一个 INSERT操作。调用该 NdbTransaction::execute() 方法时，此操作会向表中添加一个新元组。

virtual int insertTuple
    (
      void
    )

没有。

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

终止整个交易。

int interpret_exit_last_row
    (
      void
    )

没有任何

成功返回0；否则，返回 -1。

退出带有状态NOT OK和可选错误代码的解释程序（请参阅 第 2.4.2 节，“NDB 错误代码：按类型”）。

int interpret_exit_nok
    (
      Uint32 ErrorCode
    )

int interpret_exit_nok
    (
      void
    )

0 成功，-1 否则。

以 status 退出解释程序OK。

int interpret_exit_ok
    (
      void
    )

没有任何

0 成功，-1 否则。

使用解释程序删除元组。

virtual 
int interpretedDeleteTuple
    (
      void
    )

没有。

0 成功，-1 否则。

使用解释程序更新元组。

virtual
int interpretedUpdateTuple
    (
      void
    )

没有。

0 成功，-1 否则。

使用解释程序编写元组。

virtual
int interpretedWriteTuple
    (
      void
    )

没有。

0 成功，-1 否则。

将 32 位常量值加载到寄存器中。

int load_const_u32
    (
      Uint32 RegDest, 
      Uint32 Constant
    )

0 成功，-1 否则。

将 64 位常量值加载到寄存器中。

int load_const_u64
    (
      Uint64 RegDest, 
      Uint64 Constant
    )

0 成功，否则 -1。

载入NULL寄存器。

int load_const_null
    (
      Uint32 RegDest
    )

0 成功，-1 否则。

此类型描述执行读取操作时使用的锁定模式。

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

还支持脏读 ( LM_Dirty)，但这通常仅供内部使用，不应用于部署在生产环境中的应用程序。

NdbOperation

这些选项被传递给 和 类 NdbRecord中定义的基于主键和扫描的接管操作方法 。NdbTransactionNdbScanOperation

大多数NdbTransaction::*Tuple()方法（请参阅第 2.3.25 节，“NdbTransaction 类”）采用补充sizeOfOptions 参数。这是可选的，旨在允许接口实现与旧的未重新编译的客户端保持向后兼容，这些客户端可能会传递旧（较小）版本的OperationOptions 结构。这个效果是通过传入 sizeof(OperationOptions)这个参数来实现的。

通过在 中设置相应的位来将每个选项类型标记为存在 optionsPresent。（只有标记为optionsPresent 需要的选项类型具有敏感数据。）所有数据都 OperationOptions在操作定义时从结构（和任何对向结构）中复制出来。如果不需要任何选项，则NULL可以改为传递。

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

将由名称或 ID 标识的属性读入寄存器。

int read_attr
    (
      const char* anAttrName, 
      Uint32 RegDest
    )

int read_attr
    (
      Uint32 anAttrId, 
      Uint32 RegDest
    )

成功时，0；否则，-1。

此方法将 定义 NdbOperation为一个 READ操作。NdbTransaction::execute() 调用 该方法时 ，该操作会读取一个元组。

virtual int readTuple
    (
      LockMode mode
    )

mode指定读操作使用的锁定模式。有关可能的值，请参阅 NdbOperation::LockMode。

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

从解释的程序子例程返回。

int ret_sub
    (
      void
    )

没有。

0 成功，-1 否则。

此方法定义要设置或更新的属性。

有许多 NdbOperation::setValue() 方法将某种类型作为输入（按值传递而不是传递指针）。应用程序员有责任使用正确的类型。

NDB API 会检查应用程序是否按照长度参数中给定的长度向接口发送了正确的长度。值 char*可以包含任何数据类型或任何类型的数组。如果未提供长度，或者将其设置为零，则 API 会假定指针是正确的，并且不会对其进行检查。

要设置一个NULL值，请使用以下构造：

setValue("ATTR_NAME", (char*)NULL);

当您使用insertTuple()时，NDB API 会自动检测到应该使用它 equal()。

此外，在使用时没有必要 在其他属性之前insertTuple()使用 setValue()关键属性。

有 14 个版本 NdbOperation::setValue()，每个版本的参数略有不同，如下所列：

int setValue
    (
      const char* name,
      const char* value
)

int setValue
    (
      const char* name,
      Int32       value
    )

int setValue
    (
      const char* name,
      Uint32      value
    )

int setValue
    (
      const char* name,
      Int64       value
    )

int setValue
    (
      const char* name,
      Uint64      value
    )

int setValue
    (
      const char* name,
      float       value
    )

int setValue
    (
      const char* name,
      double      value
    )

int setValue
    (
      Uint32      id,
      const char* value
    )

int setValue
    (
      Uint32 id,
      Int32  value
    )

int setValue
    (
      Uint32 id,
      Uint32 value
    )

int setValue
    (
      Uint32 id,
      Int64  value
    )

int setValue
    (
      Uint32 id,
      Uint64 value
    )

int setValue
    (
      Uint32 id,
      float  value
    )

int setValue
    (
      Uint32 id,
      double value
    )

该方法需要以下两个参数：

-1失败时 返回。

NdbOperation

此结构用于指定要设置为操作一部分的额外值NdbRecord 。

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

将两个寄存器值的差值存储在第三个寄存器中。

int sub_reg
    (
      Uint32 RegSource1, 
      Uint32 RegSource2, 
      Uint32 RegDest
    )

0 成功，否则 -1。

解释性程序指令，它在解释性操作中从属性中减去一个值。属性可以按名称或 ID 指定。因此，此方法有四个版本，参数略有不同，如Signature下所示。

与 一样 incValue()，该指令使用寄存器 6 和 7，并在其操作过程中覆盖这些寄存器。

对于扫描和NdbRecord 操作，请改用 NdbInterpretedCode 界面。

int subValue
    (
      const char* anAttrName, 
      Uint32 aValue
    )

int subValue
    (
      const char* anAttrName, 
      Uint64 aValue
    )

int subValue
    (
      Uint32 anAttrId, 
      Uint32 aValue
    )

int subValue
    (
      Uint32 anAttrId, 
      Uint64 aValue
    )

0 成功，-1 否则。

Type用于描述操作访问类型。每种访问类型都 NdbOperation由其子类之一支持，如下表所示：

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

此方法将 定义 NdbOperation为一个 UPDATE操作。NdbTransaction::execute() 调用 该方法时 ，该操作会更新在表中找到的元组。

virtual int updateTuple
    (
      void
    )

没有。

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

从寄存器写入属性值。要写入的属性可以通过名称或 ID 指定。

int write_attr
    (
      const char* anAttrName, 
      Uint32 RegSource
    )

int write_attr
    (
      Uint32 anAttrId, 
      Uint32 RegSource
    )

成功返回0；否则，返回 -1。

此方法将 定义 NdbOperation为一个 WRITE操作。调用该 NdbTransaction::execute() 方法时，操作会将一个元组写入表中。如果元组已经存在，则更新；否则插入发生。

virtual int writeTuple
    (
      void
    )

没有。

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