A tuple is similar to a row in a database table: it is a container for data. Specifically, it is a sequence of named elements called fields (similar to the columns in a database table) which contain values of a specific type. Each tuple in a space represents a set of related data.
Table 4, Field Type Conversions shows which type conversions are supported. The letters in the table have the following meanings:
x: Conversion is supported with no loss of precision.
l: Conversion is supported, but with loss of precision.
There is a get and
put method for each type of field. In Java, an overloaded
put method is also provided for convenience.
Some of the fields in a tuple are considered as key fields, as specified in the space’s definition.
Most batch space operations return results (or collections of results). Results objects contain information about the result of the operation and are always returned by those operations regardless of the operation being a success or a failure.
See Appendix A, Result and Status Codes for more detailed information on results.