Package org.apache.pulsar.transaction.coordinator.impl

Class MLTransactionMetadataStore

java.lang.Object

org.apache.pulsar.transaction.coordinator.TransactionMetadataStoreState

org.apache.pulsar.transaction.coordinator.impl.MLTransactionMetadataStore

All Implemented Interfaces:

TransactionMetadataStore

public class MLTransactionMetadataStore
extends TransactionMetadataStoreState
implements TransactionMetadataStore

The provider that offers managed ledger implementation of TransactionMetadataStore.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.pulsar.transaction.coordinator.TransactionMetadataStoreState

TransactionMetadataStoreState.State

Field Summary

Fields

Modifier and Type	Field	Description
final RecoverTimeRecord	recoverTime

Constructor Summary

Constructors

Constructor	Description
MLTransactionMetadataStore(TransactionCoordinatorID tcID, MLTransactionLogImpl mlTransactionLog, TransactionTimeoutTracker timeoutTracker, MLTransactionSequenceIdGenerator sequenceIdGenerator, long maxActiveTransactionsPerCoordinator)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Void>	addAckedPartitionToTxn(org.apache.pulsar.client.api.transaction.TxnID txnID, List<TransactionSubscription> txnSubscriptions)	Add the acked partitions to transaction identified by txnid.
CompletableFuture<Void>	addProducedPartitionToTxn(org.apache.pulsar.client.api.transaction.TxnID txnID, List<String> partitions)	Add the produced partitions to transaction identified by txnid.
CompletableFuture<Void>	closeAsync()	Close the transaction metadata store.
TransactionMetadataStoreAttributes	getAttributes()	Get the transaction metadata store OpenTelemetry attributes.
TransactionCoordinatorStats	getCoordinatorStats()	Get the transaction metadata store stats.
long	getLowWaterMark()	Get the low water mark of this tc, in order to delete unless transaction in transaction buffer and pending ack.
ManagedLedger	getManagedLedger()
TransactionMetadataStoreStats	getMetadataStoreStats()	Get the transaction metadata store stats.
List<TxnMeta>	getSlowTransactions(long timeout)	Get the transactions witch timeout is bigger than given timeout.
TransactionCoordinatorID	getTransactionCoordinatorID()	Get the transaction coordinator id.
CompletableFuture<TxnMeta>	getTxnMeta(org.apache.pulsar.client.api.transaction.TxnID txnID)	Query the TxnMeta of a given transaction txnid.
CompletableFuture<TxnStatus>	getTxnStatus(org.apache.pulsar.client.api.transaction.TxnID txnID)	Query the TxnStatus of a given transaction txnid.
CompletableFuture<TransactionMetadataStore>	init(TransactionRecoverTracker recoverTracker)
CompletableFuture<org.apache.pulsar.client.api.transaction.TxnID>	newTransaction(long timeOut, String owner)	Create a new transaction in the transaction metadata store.
static List<TransactionSubscription>	subscriptionToTxnSubscription(List<Subscription> subscriptions)
static List<Subscription>	txnSubscriptionToSubscription(List<TransactionSubscription> tnxSubscriptions)
CompletableFuture<Void>	updateTxnStatus(org.apache.pulsar.client.api.transaction.TxnID txnID, TxnStatus newStatus, TxnStatus expectedStatus, boolean isTimeout)	Update the transaction from expectedStatus to newStatus.

Methods inherited from class org.apache.pulsar.transaction.coordinator.TransactionMetadataStoreState

changeToCloseState, changeToClosingState, changeToInitializingState, changeToReadyState, checkIfReady, getState

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

recoverTime

public final RecoverTimeRecord recoverTime

Constructor Details

MLTransactionMetadataStore

public MLTransactionMetadataStore(TransactionCoordinatorID tcID,
 MLTransactionLogImpl mlTransactionLog,
 TransactionTimeoutTracker timeoutTracker,
 MLTransactionSequenceIdGenerator sequenceIdGenerator,
 long maxActiveTransactionsPerCoordinator)

Method Details

init

public CompletableFuture<TransactionMetadataStore> init(TransactionRecoverTracker recoverTracker)

getTxnStatus

public CompletableFuture<TxnStatus> getTxnStatus(org.apache.pulsar.client.api.transaction.TxnID txnID)

Description copied from interface: TransactionMetadataStore

Query the TxnStatus of a given transaction txnid.

Specified by:

getTxnStatus in interface TransactionMetadataStore

Parameters:

txnID - transaction id

Returns:

a future represents the result of this operation. it returns TxnStatus of the given transaction.

getTxnMeta

public CompletableFuture<TxnMeta> getTxnMeta(org.apache.pulsar.client.api.transaction.TxnID txnID)

Description copied from interface: TransactionMetadataStore

Query the TxnMeta of a given transaction txnid.

Specified by:

getTxnMeta in interface TransactionMetadataStore

Parameters:

txnID - transaction id

Returns:

a future represents the result of this operation. it returns TxnMeta of the given transaction.

newTransaction

public CompletableFuture<org.apache.pulsar.client.api.transaction.TxnID> newTransaction(long timeOut,
 String owner)

Description copied from interface: TransactionMetadataStore

Create a new transaction in the transaction metadata store.

Specified by:

newTransaction in interface TransactionMetadataStore

Parameters:

timeOut - the timeout duration of the transaction in mills

owner - the role which is the owner of the transaction

Returns:

a future represents the result of creating a new transaction. it returns TxnID as the identifier for identifying the transaction.

addProducedPartitionToTxn

public CompletableFuture<Void> addProducedPartitionToTxn(org.apache.pulsar.client.api.transaction.TxnID txnID,
 List<String> partitions)

Description copied from interface: TransactionMetadataStore

Add the produced partitions to transaction identified by txnid.

Specified by:

addProducedPartitionToTxn in interface TransactionMetadataStore

Parameters:

txnID - transaction id

partitions - the list of partitions that a transaction produces to

Returns:

a future represents the result of this operation

addAckedPartitionToTxn

public CompletableFuture<Void> addAckedPartitionToTxn(org.apache.pulsar.client.api.transaction.TxnID txnID,
 List<TransactionSubscription> txnSubscriptions)

Description copied from interface: TransactionMetadataStore

Add the acked partitions to transaction identified by txnid.

Specified by:

addAckedPartitionToTxn in interface TransactionMetadataStore

Parameters:

txnID - transaction id

txnSubscriptions - the list of partitions that a transaction acknowledge to

Returns:

a future represents the result of the operation

updateTxnStatus

public CompletableFuture<Void> updateTxnStatus(org.apache.pulsar.client.api.transaction.TxnID txnID,
 TxnStatus newStatus,
 TxnStatus expectedStatus,
 boolean isTimeout)

Description copied from interface: TransactionMetadataStore

Update the transaction from expectedStatus to newStatus.

If the current transaction status is not expectedStatus, the update will be failed.

Specified by:

updateTxnStatus in interface TransactionMetadataStore

Parameters:

txnID - TxnID for update txn status

newStatus - the new txn status that the transaction should be updated to

expectedStatus - the expected status that the transaction should be

isTimeout - the update txn status operation is it timeout

Returns:

a future represents the result of the operation

getLowWaterMark

public long getLowWaterMark()

Description copied from interface: TransactionMetadataStore

Get the low water mark of this tc, in order to delete unless transaction in transaction buffer and pending ack.

Specified by:

getLowWaterMark in interface TransactionMetadataStore

Returns:

long long the lowWaterMark

getTransactionCoordinatorID

public TransactionCoordinatorID getTransactionCoordinatorID()

Description copied from interface: TransactionMetadataStore

Get the transaction coordinator id.

Specified by:

getTransactionCoordinatorID in interface TransactionMetadataStore

Returns:

transaction coordinator id

getCoordinatorStats

public TransactionCoordinatorStats getCoordinatorStats()

Description copied from interface: TransactionMetadataStore

Get the transaction metadata store stats.

Specified by:

getCoordinatorStats in interface TransactionMetadataStore

Returns:

TransactionCoordinatorStats TransactionCoordinatorStats

closeAsync

public CompletableFuture<Void> closeAsync()

Description copied from interface: TransactionMetadataStore

Close the transaction metadata store.

Specified by:

closeAsync in interface TransactionMetadataStore

Returns:

a future represents the result of this operation

getMetadataStoreStats

public TransactionMetadataStoreStats getMetadataStoreStats()

Description copied from interface: TransactionMetadataStore

Get the transaction metadata store stats.

Specified by:

getMetadataStoreStats in interface TransactionMetadataStore

Returns:

TransactionMetadataStoreStats TransactionMetadataStoreStats

getSlowTransactions

public List<TxnMeta> getSlowTransactions(long timeout)

Description copied from interface: TransactionMetadataStore

Get the transactions witch timeout is bigger than given timeout.

Specified by:

getSlowTransactions in interface TransactionMetadataStore

Returns:

TxnMeta the txnMetas of slow transactions

txnSubscriptionToSubscription

public static List<Subscription> txnSubscriptionToSubscription(List<TransactionSubscription> tnxSubscriptions)

subscriptionToTxnSubscription

public static List<TransactionSubscription> subscriptionToTxnSubscription(List<Subscription> subscriptions)

getManagedLedger

public ManagedLedger getManagedLedger()

getAttributes

public TransactionMetadataStoreAttributes getAttributes()

Description copied from interface: TransactionMetadataStore

Get the transaction metadata store OpenTelemetry attributes.

Specified by:

getAttributes in interface TransactionMetadataStore

Returns:

TransactionMetadataStoreAttributes TransactionMetadataStoreAttributes