org.apache.hudi.client.transaction

Interface ConflictResolutionStrategy

All Known Implementing Classes:

BucketIndexConcurrentFileWritesConflictResolutionStrategy, PreferWriterConflictResolutionStrategy, SimpleConcurrentFileWritesConflictResolutionStrategy

public interface ConflictResolutionStrategy

Strategy interface for conflict resolution with multiple writers. Users can provide pluggable implementations for different kinds of strategies to resolve conflicts when multiple writers are mutating the hoodie table.

Method Summary

Modifier and Type	Method and Description
Stream<HoodieInstant>	getCandidateInstants(HoodieTableMetaClient metaClient, HoodieInstant currentInstant, Option<HoodieInstant> lastSuccessfulInstant) Stream of instants to check conflicts against.
boolean	hasConflict(ConcurrentOperation thisOperation, ConcurrentOperation otherOperation) Implementations of this method will determine whether a conflict exists between 2 commits.
boolean	isPreCommitRequired() Write clients uses their preCommit API to run conflict resolution.
Option<HoodieCommitMetadata>	resolveConflict(HoodieTable table, ConcurrentOperation thisOperation, ConcurrentOperation otherOperation) Implementations of this method will determine how to resolve a conflict between 2 commits.

Method Detail

getCandidateInstants

Stream<HoodieInstant> getCandidateInstants(HoodieTableMetaClient metaClient,
                                           HoodieInstant currentInstant,
                                           Option<HoodieInstant> lastSuccessfulInstant)

Stream of instants to check conflicts against.

Returns:

hasConflict

@PublicAPIMethod(maturity=EVOLVING)
boolean hasConflict(ConcurrentOperation thisOperation,
                                                        ConcurrentOperation otherOperation)

Implementations of this method will determine whether a conflict exists between 2 commits.

Parameters:

thisOperation -

otherOperation -

Returns:

resolveConflict

@PublicAPIMethod(maturity=EVOLVING)
Option<HoodieCommitMetadata> resolveConflict(HoodieTable table,
                                                                                 ConcurrentOperation thisOperation,
                                                                                 ConcurrentOperation otherOperation)
                                                                          throws HoodieWriteConflictException

Implementations of this method will determine how to resolve a conflict between 2 commits.

Parameters:

thisOperation -

otherOperation -

Returns:

Throws:

HoodieWriteConflictException

isPreCommitRequired

@PublicAPIMethod(maturity=EVOLVING)
boolean isPreCommitRequired()

Write clients uses their preCommit API to run conflict resolution. This method determines whether to execute preCommit for table services like clustering.

Returns:

boolean