Class SketchBasedJoinEstimator.Config

java.lang.Object

org.eclipse.rdf4j.query.algebra.evaluation.sketch.SketchBasedJoinEstimator.Config

Enclosing class:

SketchBasedJoinEstimator

public static final class SketchBasedJoinEstimator.Config
extends Object

Configuration for SketchBasedJoinEstimator.

Defaults use explicit S/P/O/C bucket counts and 64 sketch nominal entries.

Constructor Summary

Constructors

Constructor	Description
Config()

Method Summary

Modifier and Type	Method	Description
static SketchBasedJoinEstimator.Config	defaults()	Return a new config with all defaults.
SketchBasedJoinEstimator.Config	withChurnReaddThreshold(double fraction)	Threshold for the share of sampled statements that were added, deleted, and re-added.
SketchBasedJoinEstimator.Config	withChurnRemovalRatioThreshold(double fraction)	Threshold for the ratio of removed to added sampled statements.
SketchBasedJoinEstimator.Config	withChurnSampleMax(int max)	Upper bound on sampling frequency expressed as a minimum spacing (in statements) between sampled churn events.
SketchBasedJoinEstimator.Config	withChurnSampleMin(int min)	Minimum number of statements to sample before switching to probabilistic sampling.
SketchBasedJoinEstimator.Config	withChurnSamplePercent(double fraction)	Fraction (0..1) of statements to sample after the minimum set is populated.
SketchBasedJoinEstimator.Config	withContextBucketCount(int n)
SketchBasedJoinEstimator.Config	withContextPairSketchesEnabled(boolean enabled)
SketchBasedJoinEstimator.Config	withDefaultContext(String s)	Label used when a statement has null context.
SketchBasedJoinEstimator.Config	withEstimateCacheSeconds(long seconds)	Cache raw pattern estimates for up to the configured number of seconds.
SketchBasedJoinEstimator.Config	withIncrementalQueueEstimatedStatementBytes(long bytes)
SketchBasedJoinEstimator.Config	withIncrementalQueueIdleResetMillis(long millis)
SketchBasedJoinEstimator.Config	withIncrementalQueueInitialLimit(int limit)
SketchBasedJoinEstimator.Config	withMemoryMonitorCheckInterval(int interval)
SketchBasedJoinEstimator.Config	withMemoryMonitorEstimatedOperationBytes(long bytes)
SketchBasedJoinEstimator.Config	withNominalEntries(int n)	Sketch nominal entries (must be ≥ 16).
SketchBasedJoinEstimator.Config	withObjectBucketCount(int n)
SketchBasedJoinEstimator.Config	withoutContextPairSketches()
SketchBasedJoinEstimator.Config	withPredicateBucketCount(int n)
SketchBasedJoinEstimator.Config	withRefreshSleepMillis(long ms)	Background refresh thread sleep between checks/rebuilds in milliseconds.
SketchBasedJoinEstimator.Config	withRoundJoinEstimates(boolean round)	Round join size estimates to the nearest integer.
SketchBasedJoinEstimator.Config	withSubjectBucketCount(int n)
SketchBasedJoinEstimator.Config	withThrottleEveryN(long n)	Sleep every N scanned statements during a full rebuild.
SketchBasedJoinEstimator.Config	withThrottleMillis(long ms)	Milliseconds to sleep when throttling during a rebuild.
SketchBasedJoinEstimator.Config	withZeroIntersectionExactDistinctLimit(int limit)	Exact distinct limit for zero-intersection rare-overlap fallback before downgrading to row sampling.
SketchBasedJoinEstimator.Config	withZeroIntersectionRowBudget(long rows)	Maximum estimated scan-side rows allowed for zero-intersection fallback work.
SketchBasedJoinEstimator.Config	withZeroIntersectionSampleSize(int sampleSize)	Reservoir size for sampled zero-intersection fallback when the exact distinct limit is exceeded.
SketchBasedJoinEstimator.Config	withZeroIntersectionSkewRatio(double ratio)	Distinct skew ratio required to try a zero-intersection fallback when exact fallback is not eligible.

Methods inherited from class Object

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

Constructor Details

Config

public Config()

Method Details

defaults

public static SketchBasedJoinEstimator.Config defaults()

Return a new config with all defaults.

withNominalEntries

public SketchBasedJoinEstimator.Config withNominalEntries(int n)

Sketch nominal entries (must be ≥ 16).

withSubjectBucketCount

public SketchBasedJoinEstimator.Config withSubjectBucketCount(int n)

withPredicateBucketCount

public SketchBasedJoinEstimator.Config withPredicateBucketCount(int n)

withObjectBucketCount

public SketchBasedJoinEstimator.Config withObjectBucketCount(int n)

withContextBucketCount

public SketchBasedJoinEstimator.Config withContextBucketCount(int n)

withContextPairSketchesEnabled

public SketchBasedJoinEstimator.Config withContextPairSketchesEnabled(boolean enabled)

withoutContextPairSketches

public SketchBasedJoinEstimator.Config withoutContextPairSketches()

withThrottleEveryN

public SketchBasedJoinEstimator.Config withThrottleEveryN(long n)

Sleep every N scanned statements during a full rebuild.

withThrottleMillis

public SketchBasedJoinEstimator.Config withThrottleMillis(long ms)

Milliseconds to sleep when throttling during a rebuild.

withRefreshSleepMillis

public SketchBasedJoinEstimator.Config withRefreshSleepMillis(long ms)

Background refresh thread sleep between checks/rebuilds in milliseconds.

withEstimateCacheSeconds

public SketchBasedJoinEstimator.Config withEstimateCacheSeconds(long seconds)

Cache raw pattern estimates for up to the configured number of seconds.

withZeroIntersectionExactDistinctLimit

public SketchBasedJoinEstimator.Config withZeroIntersectionExactDistinctLimit(int limit)

Exact distinct limit for zero-intersection rare-overlap fallback before downgrading to row sampling.

withZeroIntersectionSkewRatio

public SketchBasedJoinEstimator.Config withZeroIntersectionSkewRatio(double ratio)

Distinct skew ratio required to try a zero-intersection fallback when exact fallback is not eligible.

withZeroIntersectionRowBudget

public SketchBasedJoinEstimator.Config withZeroIntersectionRowBudget(long rows)

Maximum estimated scan-side rows allowed for zero-intersection fallback work.

withZeroIntersectionSampleSize

public SketchBasedJoinEstimator.Config withZeroIntersectionSampleSize(int sampleSize)

Reservoir size for sampled zero-intersection fallback when the exact distinct limit is exceeded.

withDefaultContext

public SketchBasedJoinEstimator.Config withDefaultContext(String s)

Label used when a statement has null context.

withRoundJoinEstimates

public SketchBasedJoinEstimator.Config withRoundJoinEstimates(boolean round)

Round join size estimates to the nearest integer.

withChurnSampleMin

public SketchBasedJoinEstimator.Config withChurnSampleMin(int min)

Minimum number of statements to sample before switching to probabilistic sampling.

withChurnSamplePercent

public SketchBasedJoinEstimator.Config withChurnSamplePercent(double fraction)

Fraction (0..1) of statements to sample after the minimum set is populated.

withChurnSampleMax

public SketchBasedJoinEstimator.Config withChurnSampleMax(int max)

Upper bound on sampling frequency expressed as a minimum spacing (in statements) between sampled churn events. If the percentage-derived interval is smaller than this value, sampling is throttled to this spacing.

withChurnReaddThreshold

public SketchBasedJoinEstimator.Config withChurnReaddThreshold(double fraction)

Threshold for the share of sampled statements that were added, deleted, and re-added.

withChurnRemovalRatioThreshold

public SketchBasedJoinEstimator.Config withChurnRemovalRatioThreshold(double fraction)

Threshold for the ratio of removed to added sampled statements.

withIncrementalQueueInitialLimit

public SketchBasedJoinEstimator.Config withIncrementalQueueInitialLimit(int limit)

withIncrementalQueueIdleResetMillis

public SketchBasedJoinEstimator.Config withIncrementalQueueIdleResetMillis(long millis)

withIncrementalQueueEstimatedStatementBytes

public SketchBasedJoinEstimator.Config withIncrementalQueueEstimatedStatementBytes(long bytes)

withMemoryMonitorCheckInterval

public SketchBasedJoinEstimator.Config withMemoryMonitorCheckInterval(int interval)

withMemoryMonitorEstimatedOperationBytes

public SketchBasedJoinEstimator.Config withMemoryMonitorEstimatedOperationBytes(long bytes)