Class BulkMutation (2.14.0)

public final class BulkMutation implements Serializable, Cloneable

Represents a list of mutations for multiple rows. Each mutation contains multiple changes that will be atomically applied to each row. However, ordering between rows is not guaranteed.

This class is meant for manual batching.

Inheritance

java.lang.Object > BulkMutation

Implements

Serializable, Cloneable

Static Methods

create(String tableId)

public static BulkMutation create(String tableId)
Parameter
NameDescription
tableIdString
Returns
TypeDescription
BulkMutation

fromProto(MutateRowsRequest request)

public static BulkMutation fromProto(MutateRowsRequest request)

Wraps the protobuf MutateRowsRequest.

This is meant for advanced usage only. Please ensure that the MutateRowsRequest does not use server side timestamps. The BigtableDataClient assumes that mutation present in BulkMutation are idempotent and is configured to enable retries by default. If serverside timestamps are enabled then that can lead to duplicate mutations.

WARNING: when applied, the resulting mutation object will ignore the project id and instance id in the table_name and instead apply the configuration in the client.

Parameter
NameDescription
requestMutateRowsRequest
Returns
TypeDescription
BulkMutation

Methods

add(RowMutationEntry entry)

public BulkMutation add(RowMutationEntry entry)

Add mutation for a particular row. The changes in the mutation will be applied atomic. However there is no guarantees about the relative ordering between mutations affecting different rows.

Parameter
NameDescription
entryRowMutationEntry
Returns
TypeDescription
BulkMutation

add(ByteString rowKey, Mutation mutation)

public BulkMutation add(ByteString rowKey, Mutation mutation)

Add mutation for a particular row. The changes in the mutation will be applied atomic. However there is no guarantees about the relative ordering between mutations affecting different rows.

Parameters
NameDescription
rowKeyByteString
mutationMutation
Returns
TypeDescription
BulkMutation

add(String rowKey, Mutation mutation)

public BulkMutation add(String rowKey, Mutation mutation)

Add mutation for a particular row. The changes in the mutation will be applied atomically. However there is no guarantees about the relative ordering between mutations affecting different rows.

Parameters
NameDescription
rowKeyString
mutationMutation
Returns
TypeDescription
BulkMutation

clone()

public BulkMutation clone()

Creates a copy of BulkMutation.

Returns
TypeDescription
BulkMutation
Overrides

getEntryCount()

public int getEntryCount()
Returns
TypeDescription
int

toProto(RequestContext requestContext)

public MutateRowsRequest toProto(RequestContext requestContext)
Parameter
NameDescription
requestContextcom.google.cloud.bigtable.data.v2.internal.RequestContext
Returns
TypeDescription
MutateRowsRequest