Package org.apache.polaris.persistence.nosql.api.commit

Interface RetryConfig.BuildableRetryConfig

All Superinterfaces:

RetryConfig

Enclosing interface:

RetryConfig

@PolarisImmutable
public static interface RetryConfig.BuildableRetryConfig
extends RetryConfig

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.polaris.persistence.nosql.api.commit.RetryConfig

RetryConfig.BuildableRetryConfig

Field Summary

Fields inherited from interface org.apache.polaris.persistence.nosql.api.commit.RetryConfig

DEFAULT_RETRIES, DEFAULT_RETRY_CONFIG, DEFAULT_RETRY_INITIAL_SLEEP_LOWER, DEFAULT_RETRY_INITIAL_SLEEP_UPPER, DEFAULT_RETRY_MAX_SLEEP, DEFAULT_TIMEOUT

Method Summary

Modifier and Type	Method	Description
static org.apache.polaris.persistence.nosql.api.commit.ImmutableBuildableRetryConfig.Builder	builder()
default FairRetriesType	fairRetries()	Without mitigation, very frequently started retry-loops running against highly contended resources can result in some retry-loops invocations never making any progress and eventually time out.
default Duration	initialSleepLower()	Initial lower bound for a retry-sleep duration for the retry-loop, defaults to RetryConfig.DEFAULT_RETRY_INITIAL_SLEEP_LOWER.
default Duration	initialSleepUpper()	Initial upper bound for a retry-sleep duration for the retry-loop, defaults to RetryConfig.DEFAULT_RETRY_INITIAL_SLEEP_UPPER.
default Duration	maxSleep()	Maximum retry-sleep duration, defaults to RetryConfig.DEFAULT_RETRY_MAX_SLEEP.
default int	retries()	Maximum number of allowed retries, defaults to "10000".
default Duration	timeout()	Maximum allowed time until a retry-loop and commits fails with a RetryTimeoutException, defaults to "PT15S".

Method Details

builder

static org.apache.polaris.persistence.nosql.api.commit.ImmutableBuildableRetryConfig.Builder builder()

timeout

@Default
default Duration timeout()

Description copied from interface: RetryConfig

Maximum allowed time until a retry-loop and commits fails with a RetryTimeoutException, defaults to "PT15S".

Specified by:

timeout in interface RetryConfig

retries

@Default
default int retries()

Description copied from interface: RetryConfig

Maximum number of allowed retries, defaults to "10000".

Specified by:

retries in interface RetryConfig

initialSleepLower

@Default
default Duration initialSleepLower()

Description copied from interface: RetryConfig

Initial lower bound for a retry-sleep duration for the retry-loop, defaults to RetryConfig.DEFAULT_RETRY_INITIAL_SLEEP_LOWER. This value will be doubled after each retry, as long as RetryConfig.maxSleep() is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds.

Specified by:

initialSleepLower in interface RetryConfig

initialSleepUpper

@Default
default Duration initialSleepUpper()

Description copied from interface: RetryConfig

Initial upper bound for a retry-sleep duration for the retry-loop, defaults to RetryConfig.DEFAULT_RETRY_INITIAL_SLEEP_UPPER. This value will be doubled after each retry, as long as RetryConfig.maxSleep() is not exceeded. A concrete sleep duration will be randomly chosen between the current lower and upper bounds.

Specified by:

initialSleepUpper in interface RetryConfig

maxSleep

@Default
default Duration maxSleep()

Description copied from interface: RetryConfig

Maximum retry-sleep duration, defaults to RetryConfig.DEFAULT_RETRY_MAX_SLEEP.

Specified by:

maxSleep in interface RetryConfig

fairRetries

@Default
default FairRetriesType fairRetries()

Description copied from interface: RetryConfig

Without mitigation, very frequently started retry-loops running against highly contended resources can result in some retry-loops invocations never making any progress and eventually time out.

The default "fair retries type" helps in these scenarios with sacrificing the overall throughput too much.

Specified by:

fairRetries in interface RetryConfig