constituentFor

The constituentFor method returns a single constituent for the supplied key column values.

Note

If constituentChangesPermitted() = true, this method may return different results if invoked multiple times.

The result will be managed by the enclosing liveness scope.

Syntax

constituentFor(keyColumnValues...)

Parameters

ParameterTypeDescription
keyColumnValuesObject...

Ordered, boxed values for the key columns, in the same order as keyColumnNames().

The keyColumnValues can be thought of as a tuple constraining the values for the corresponding key columns for the result row. If there are no matching rows, the result is null. If there are multiple matching rows, an UnsupportedOperationException is thrown.

Returns

A single constituent for the supplied keyColumnValues.

Examples

source = newTable(
    stringCol("X", "A", "B", "A", "C", "B", "A", "B", "B", "C"),
    stringCol("Y", "M", "N", "O", "N", "P", "M", "O", "P", "M"),
    intCol("Number", 55, 76, 20, 130, 230, 50, 73, 137, 214),
)

partitionedTable = source.partitionBy("X")

println partitionedTable.constituentFor("Number")