Skip navigation links
2.3.33 The PartitionSpec Structure »
Section Navigation      [Toggle]

2.3.32. The OperationOptions Structure

Parent class.  NdbOperation

Description.  These options are passed to the NdbRecord-based primary key and scan takeover operation methods defined in the NdbTransaction and NdbScanOperation classes.

Note

Most NdbTransaction::*Tuple() methods take a supplementary sizeOfOptions parameter. This is optional, and is intended to allow the interface implementation to remain backwards compatible with older un-recompiled clients that may pass an older (smaller) version of the OperationOptions structure. This effect is achieved by passing sizeof(OperationOptions) into this parameter.

Each option type is marked as present by setting the corresponding bit in optionsPresent. (Only the option types marked in optionsPresent need have sensible data.) All data is copied out of the OperationOptions structure (and any subtended structures) at operation definition time. If no options are required, then NULL may be passed instead.

Members.  The makeup of this structure is shown here:

NdbOperation::OperationOptions structure

The individual members are described in more detail in the following table:

Name Type Description
optionsPresent Uint64 Which flags are present.
[...] Flags:

The allowed names and values are shown in the following list:

  • OO_ABORTOPTION: 0x01

  • OO_GETVALUE: 0x02

  • OO_SETVALUE: 0x04

  • OO_PARTITION_ID: 0x08

  • OO_INTERPRETED: 0x10

  • OO_ANYVALUE: 0x20

  • OO_CUSTOMDATA: 0x40

Type of flags.
abortOption AbortOption An operation-specific abort option; necessary only if the default abortoption behavior is not satisfactory.
extraGetValues GetValueSpec* Extra column values to be read.
numExtraGetValues Uint32 Number of extra column values to be read.
extraSetValues SetValueSpec* Extra column values to be set.
numExtraSetValues Uint32 Number of extra column values to be set.
partitionId Uint32 Limit the scan to the partition having this ID; alternatively, you can supply an Ndb::PartitionSpec here. For index scans, partitioning information can be supplied for each range.
interpretedCode const NdbInterpretedCode* Interpeted code to execute as part of the scan.
anyValue Uint32 An AnyValue to be used with this operation.
customData void* Data pointer to associate with this operation.
partitionInfo const Ndb::PartitionSpec* Partition information for bounding this scan.
sizeOfPartInfo Uint32 Size of the bounding partition information.

For more information, see Section 2.3.25, “The NdbRecord Interface”.