Package org.elasticsearch.search.aggregations.bucket.terms

Class TermsAggregationBuilder

java.lang.Object

org.elasticsearch.search.aggregations.AggregationBuilder

org.elasticsearch.search.aggregations.AbstractAggregationBuilder<AB>

org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder<TermsAggregationBuilder>

org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, org.elasticsearch.common.xcontent.ToXContent, org.elasticsearch.common.xcontent.ToXContentFragment, Rewriteable<AggregationBuilder>, BaseAggregationBuilder

public class TermsAggregationBuilder
extends ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder

ValuesSourceAggregationBuilder.LeafOnly<VS extends ValuesSource,AB extends ValuesSourceAggregationBuilder<AB>>

Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.AggregationBuilder

AggregationBuilder.BucketCardinality, AggregationBuilder.CommonFields

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

org.elasticsearch.common.xcontent.ToXContent.DelegatingMapParams, org.elasticsearch.common.xcontent.ToXContent.MapParams, org.elasticsearch.common.xcontent.ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static org.elasticsearch.common.xcontent.ParseField	EXECUTION_HINT_FIELD_NAME
static org.elasticsearch.common.xcontent.ParseField	MIN_DOC_COUNT_FIELD_NAME
static String	NAME
static org.elasticsearch.common.xcontent.ParseField	ORDER_FIELD
static org.elasticsearch.common.xcontent.ObjectParser<TermsAggregationBuilder,String>	PARSER
static ValuesSourceRegistry.RegistryKey<org.elasticsearch.search.aggregations.bucket.terms.TermsAggregatorSupplier>	REGISTRY_KEY
static org.elasticsearch.common.xcontent.ParseField	REQUIRED_SIZE_FIELD_NAME
static org.elasticsearch.common.xcontent.ParseField	SHARD_MIN_DOC_COUNT_FIELD_NAME
static org.elasticsearch.common.xcontent.ParseField	SHARD_SIZE_FIELD_NAME
static org.elasticsearch.common.xcontent.ParseField	SHOW_TERM_DOC_COUNT_ERROR

Fields inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder

config

Fields inherited from class org.elasticsearch.search.aggregations.AbstractAggregationBuilder

metadata

Fields inherited from class org.elasticsearch.search.aggregations.AggregationBuilder

DEFAULT_PREALLOCATION, factoriesBuilder, name

Fields inherited from interface org.elasticsearch.index.query.Rewriteable

MAX_REWRITE_ROUNDS

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Modifier	Constructor	Description
	TermsAggregationBuilder(String name)
	TermsAggregationBuilder(StreamInput in)	Read from a stream.
protected	TermsAggregationBuilder(TermsAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder, Map<String,Object> metadata)

Method Summary

Modifier and Type	Method	Description
AggregationBuilder.BucketCardinality	bucketCardinality()	A rough count of the number of buckets that Aggregators built by this builder will contain per owning parent bucket.
Aggregator.SubAggCollectionMode	collectMode()	Expert: get the collection mode.
TermsAggregationBuilder	collectMode(Aggregator.SubAggCollectionMode collectMode)	Expert: set the collection mode.
protected ValuesSourceType	defaultValueSourceType()	Aggregations should use this method to define a ValuesSourceType of last resort.
protected org.elasticsearch.common.xcontent.XContentBuilder	doXContentBody(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params)
boolean	equals(Object obj)
String	executionHint()	Expert: gets an execution hint to the aggregation.
TermsAggregationBuilder	executionHint(String executionHint)	Expert: sets an execution hint to the aggregation.
protected ValuesSourceRegistry.RegistryKey<?>	getRegistryKey()
String	getType()	The name of the type of aggregation built by this builder.
int	hashCode()
IncludeExclude	includeExclude()	Get terms to include and exclude from the aggregation results
TermsAggregationBuilder	includeExclude(IncludeExclude includeExclude)	Set terms to include and exclude from the aggregation results
protected ValuesSourceAggregatorFactory	innerBuild(AggregationContext context, ValuesSourceConfig config, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder)
protected void	innerWriteTo(StreamOutput out)	Write subclass's state to the stream.
long	minDocCount()	Returns the minimum document count required per term
TermsAggregationBuilder	minDocCount(long minDocCount)	Set the minimum document count terms should have in order to appear in the response.
BucketOrder	order()	Gets the order in which the buckets will be returned.
TermsAggregationBuilder	order(List<BucketOrder> orders)	Sets the order in which the buckets will be returned.
TermsAggregationBuilder	order(BucketOrder order)	Set a new order on this builder and return the builder so that calls can be chained.
static void	registerAggregators(ValuesSourceRegistry.Builder builder)
protected boolean	serializeTargetValueType(Version version)	DO NOT OVERRIDE THIS!
protected AggregationBuilder	shallowCopy(AggregatorFactories.Builder factoriesBuilder, Map<String,Object> metadata)	Create a shallow copy of this builder and replacing AggregationBuilder.factoriesBuilder and metadata.
long	shardMinDocCount()	Returns the minimum document count required per term, per shard
TermsAggregationBuilder	shardMinDocCount(long shardMinDocCount)	Set the minimum document count terms should have on the shard in order to appear in the response.
int	shardSize()	Returns the number of term buckets per shard that are currently configured
TermsAggregationBuilder	shardSize(int shardSize)	Sets the shard_size - indicating the number of term buckets each shard will return to the coordinating node (the node that coordinates the search execution).
boolean	showTermDocCountError()	Get whether doc count error will be return for individual terms
TermsAggregationBuilder	showTermDocCountError(boolean showTermDocCountError)	Set whether doc count error will be return for individual terms
int	size()	Returns the number of term buckets currently configured
TermsAggregationBuilder	size(int size)	Sets the size - indicating how many term buckets should be returned (defaults to 10)

Methods inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder

declareFields, declareFields, doBuild, doWriteTo, field, field, format, format, internalXContent, missing, missing, resolveConfig, script, script, timeZone, timeZone, userValueTypeHint, userValueTypeHint

Methods inherited from class org.elasticsearch.search.aggregations.AbstractAggregationBuilder

build, getMetadata, getWriteableName, setMetadata, subAggregation, subAggregation, subAggregations, toXContent, writeTo

Methods inherited from class org.elasticsearch.search.aggregations.AggregationBuilder

buildPipelineTree, bytesToPreallocate, doRewrite, getName, getOutputFieldNames, getPipelineAggregations, getSubAggregations, rewrite, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContentFragment

isFragment

Field Details

NAME

public static final String NAME

See Also:

Constant Field Values

REGISTRY_KEY

public static final ValuesSourceRegistry.RegistryKey<org.elasticsearch.search.aggregations.bucket.terms.TermsAggregatorSupplier> REGISTRY_KEY

EXECUTION_HINT_FIELD_NAME

public static final org.elasticsearch.common.xcontent.ParseField EXECUTION_HINT_FIELD_NAME

SHARD_SIZE_FIELD_NAME

public static final org.elasticsearch.common.xcontent.ParseField SHARD_SIZE_FIELD_NAME

MIN_DOC_COUNT_FIELD_NAME

public static final org.elasticsearch.common.xcontent.ParseField MIN_DOC_COUNT_FIELD_NAME

SHARD_MIN_DOC_COUNT_FIELD_NAME

public static final org.elasticsearch.common.xcontent.ParseField SHARD_MIN_DOC_COUNT_FIELD_NAME

REQUIRED_SIZE_FIELD_NAME

public static final org.elasticsearch.common.xcontent.ParseField REQUIRED_SIZE_FIELD_NAME

SHOW_TERM_DOC_COUNT_ERROR

public static final org.elasticsearch.common.xcontent.ParseField SHOW_TERM_DOC_COUNT_ERROR

ORDER_FIELD

public static final org.elasticsearch.common.xcontent.ParseField ORDER_FIELD

PARSER

public static final org.elasticsearch.common.xcontent.ObjectParser<TermsAggregationBuilder,String> PARSER

Constructor Details

TermsAggregationBuilder

public TermsAggregationBuilder(String name)

TermsAggregationBuilder

protected TermsAggregationBuilder(TermsAggregationBuilder clone,
 AggregatorFactories.Builder factoriesBuilder,
 Map<String,Object> metadata)

TermsAggregationBuilder

public TermsAggregationBuilder(StreamInput in)
                        throws IOException

Read from a stream.

Throws:

IOException

Method Details

registerAggregators

public static void registerAggregators(ValuesSourceRegistry.Builder builder)

defaultValueSourceType

protected ValuesSourceType defaultValueSourceType()

Description copied from class: ValuesSourceAggregationBuilder

Aggregations should use this method to define a ValuesSourceType of last resort. This will only be used when the resolver can't find a field and the user hasn't provided a value type hint.

Specified by:

defaultValueSourceType in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Returns:

The CoreValuesSourceType we expect this script to yield.

shallowCopy

protected AggregationBuilder shallowCopy(AggregatorFactories.Builder factoriesBuilder,
 Map<String,Object> metadata)

Description copied from class: AggregationBuilder

Create a shallow copy of this builder and replacing AggregationBuilder.factoriesBuilder and metadata. Used by AggregationBuilder.rewrite(QueryRewriteContext).

Specified by:

shallowCopy in class AggregationBuilder

serializeTargetValueType

protected boolean serializeTargetValueType(Version version)

Description copied from class: ValuesSourceAggregationBuilder

DO NOT OVERRIDE THIS!

This method only exists for legacy support. No new aggregations need this, nor should they override it.

Overrides:

serializeTargetValueType in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Parameters:

version - For backwards compatibility, subclasses can change behavior based on the version

innerWriteTo

protected void innerWriteTo(StreamOutput out)
                     throws IOException

Description copied from class: ValuesSourceAggregationBuilder

Write subclass's state to the stream.

Specified by:

innerWriteTo in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Throws:

IOException

size

public TermsAggregationBuilder size(int size)

Sets the size - indicating how many term buckets should be returned (defaults to 10)

size

public int size()

Returns the number of term buckets currently configured

shardSize

public TermsAggregationBuilder shardSize(int shardSize)

Sets the shard_size - indicating the number of term buckets each shard will return to the coordinating node (the node that coordinates the search execution). The higher the shard size is, the more accurate the results are.

shardSize

public int shardSize()

Returns the number of term buckets per shard that are currently configured

minDocCount

public TermsAggregationBuilder minDocCount(long minDocCount)

Set the minimum document count terms should have in order to appear in the response.

minDocCount

public long minDocCount()

Returns the minimum document count required per term

shardMinDocCount

public TermsAggregationBuilder shardMinDocCount(long shardMinDocCount)

Set the minimum document count terms should have on the shard in order to appear in the response.

shardMinDocCount

public long shardMinDocCount()

Returns the minimum document count required per term, per shard

order

public TermsAggregationBuilder order(BucketOrder order)

Set a new order on this builder and return the builder so that calls can be chained. A tie-breaker may be added to avoid non-deterministic ordering.

order

public TermsAggregationBuilder order(List<BucketOrder> orders)

Sets the order in which the buckets will be returned. A tie-breaker may be added to avoid non-deterministic ordering.

order

public BucketOrder order()

Gets the order in which the buckets will be returned.

executionHint

public TermsAggregationBuilder executionHint(String executionHint)

Expert: sets an execution hint to the aggregation.

executionHint

public String executionHint()

Expert: gets an execution hint to the aggregation.

collectMode

public TermsAggregationBuilder collectMode(Aggregator.SubAggCollectionMode collectMode)

Expert: set the collection mode.

collectMode

public Aggregator.SubAggCollectionMode collectMode()

Expert: get the collection mode.

includeExclude

public TermsAggregationBuilder includeExclude(IncludeExclude includeExclude)

Set terms to include and exclude from the aggregation results

includeExclude

public IncludeExclude includeExclude()

Get terms to include and exclude from the aggregation results

showTermDocCountError

public boolean showTermDocCountError()

Get whether doc count error will be return for individual terms

showTermDocCountError

public TermsAggregationBuilder showTermDocCountError(boolean showTermDocCountError)

Set whether doc count error will be return for individual terms

bucketCardinality

public AggregationBuilder.BucketCardinality bucketCardinality()

Description copied from class: AggregationBuilder

A rough count of the number of buckets that Aggregators built by this builder will contain per owning parent bucket.

Specified by:

bucketCardinality in class AggregationBuilder

innerBuild

protected ValuesSourceAggregatorFactory innerBuild(AggregationContext context,
 ValuesSourceConfig config,
 AggregatorFactory parent,
 AggregatorFactories.Builder subFactoriesBuilder)
                                            throws IOException

Specified by:

innerBuild in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Throws:

IOException

doXContentBody

protected org.elasticsearch.common.xcontent.XContentBuilder doXContentBody(org.elasticsearch.common.xcontent.XContentBuilder builder,
 org.elasticsearch.common.xcontent.ToXContent.Params params)
                                                                    throws IOException

Specified by:

doXContentBody in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

Throws:

IOException

hashCode

public int hashCode()

Overrides:

hashCode in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

equals

public boolean equals(Object obj)

Overrides:

equals in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>

getType

public String getType()

Description copied from interface: BaseAggregationBuilder

The name of the type of aggregation built by this builder.

getRegistryKey

protected ValuesSourceRegistry.RegistryKey<?> getRegistryKey()

Specified by:

getRegistryKey in class ValuesSourceAggregationBuilder<TermsAggregationBuilder>