This method is used with
NdbRecord to write a tuple of
const NdbOperation* writeTuple ( const NdbRecord* key_rec, const char* key_row, const NdbRecord* attr_rec, const char* attr_row, const unsigned char* mask = 0, const NdbOperation::OperationOptions* opts = 0, Uint32 sizeOfOptions = 0 )
Parameters. This method takes the following parameters:
key_recis a pointer to an
NdbRecordfor either a table or an index. If on a table, then the operation uses a primary key; if on an index, then the operation uses a unique key. In either case, the
key_recmust include all columns of the key.
key_rowpassed to this method defines the primary or unique key of the tuple to be written, and must remain valid until
NdbRecordreferencing the attribute to be written.Note
For unique index operations, the
attr_recmust refer to the underlying table of the index, not to the index itself.
attr_rowis a buffer containing the new data.
mask, if not
NULL, defines a subset of attributes to be written. The mask is copied, and so does not need to remain valid after the call to this method returns.
opts) can be used to provide more finely-grained control of operation definitions. An
OperationOptionsstructure is passed with flags indicating which operation definition options are present. Not all operation types support all operation options; for the options supported by each type of operation, see Section 126.96.36.199, “NdbTransaction::readTuple()”.
sizeOfOptionsparameter is used to provide backward compatibility of this interface with previous definitions of the
OperationOptionsstructure. If an unusual size is detected by the interface implementation, it can use this to determine how to interpret the passed
OperationOptionsstructure. To enable this functionality, the caller should pass
sizeof(NdbOperation::OperationOptions)for the value of this argument.
const pointer to the
NdbOperation representing this
write operation. The operation can be checked for errors if and