Module org.elasticsearch.compute

Package org.elasticsearch.compute.lucene

Class TimeSeriesSourceOperator

java.lang.Object

org.elasticsearch.compute.operator.SourceOperator

org.elasticsearch.compute.lucene.LuceneOperator

org.elasticsearch.compute.lucene.LuceneSourceOperator

org.elasticsearch.compute.lucene.TimeSeriesSourceOperator

All Implemented Interfaces:

Closeable, AutoCloseable, Operator, org.elasticsearch.core.Releasable

public final class TimeSeriesSourceOperator
extends LuceneSourceOperator

Extension of LuceneSourceOperator for time-series aggregation that inserts metadata blocks, such as slice index and future max timestamp, to allow downstream operators to optimize processing.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	TimeSeriesSourceOperator.Factory

Nested classes/interfaces inherited from class org.elasticsearch.compute.lucene.LuceneOperator

LuceneOperator.Status

Nested classes/interfaces inherited from class org.elasticsearch.compute.operator.SourceOperator

SourceOperator.SourceOperatorFactory

Nested classes/interfaces inherited from interface org.elasticsearch.compute.operator.Operator

Operator.OperatorFactory

Field Summary

Fields inherited from class org.elasticsearch.compute.lucene.LuceneOperator

blockFactory, currentSlice, NO_LIMIT, shardContextCounters

Fields inherited from interface org.elasticsearch.compute.operator.Operator

MIN_TARGET_PAGE_SIZE, NOT_BLOCKED, TARGET_PAGE_SIZE

Constructor Summary

Constructors

Constructor	Description
TimeSeriesSourceOperator(List<? extends org.elasticsearch.core.RefCounted> shardContextCounters, BlockFactory blockFactory, int maxPageSize, LuceneSliceQueue sliceQueue, int limit, Limiter limiter)

Method Summary

Modifier and Type	Method	Description
protected void	buildMetadataBlocks(Block[] blocks, int offset, int currentPagePos)
protected int	numMetadataBlocks()
static int	pageSize(long estimateRowSizeInBytes, long maxPageSizeInBytes)	For time-series queries, try to use a page size that is a multiple of CHUNK_SIZE (see NUMERIC_BLOCK_SIZE in the tsdb codec) to enable bulk loading of numeric or tsid fields.

Methods inherited from class org.elasticsearch.compute.lucene.LuceneSourceOperator

additionalClose, describe, finish, getCheckedOutput, isFinished

Methods inherited from class org.elasticsearch.compute.lucene.LuceneOperator

close, getOutput, status, toString

Methods inherited from class org.elasticsearch.compute.operator.SourceOperator

addInput, needsInput

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.compute.operator.Operator

isBlocked

Constructor Details

TimeSeriesSourceOperator

public TimeSeriesSourceOperator(List<? extends org.elasticsearch.core.RefCounted> shardContextCounters,
 BlockFactory blockFactory,
 int maxPageSize,
 LuceneSliceQueue sliceQueue,
 int limit,
 Limiter limiter)

Method Details

numMetadataBlocks

protected int numMetadataBlocks()

Overrides:

numMetadataBlocks in class LuceneSourceOperator

buildMetadataBlocks

protected void buildMetadataBlocks(Block[] blocks,
 int offset,
 int currentPagePos)

Overrides:

buildMetadataBlocks in class LuceneSourceOperator

pageSize

public static int pageSize(long estimateRowSizeInBytes,
 long maxPageSizeInBytes)

For time-series queries, try to use a page size that is a multiple of CHUNK_SIZE (see NUMERIC_BLOCK_SIZE in the tsdb codec) to enable bulk loading of numeric or tsid fields. Avoid pages that are too large, as this can disable bulk loading if there are holes in the doc IDs and disable constant block optimizations. Therefore, we cap the page size at 2048, which balances the overhead per page with the benefits of bulk loading and constant blocks.