Package org.elasticsearch.client.rollup.job.config

Class DateHistogramGroupConfig

java.lang.Object

org.elasticsearch.client.rollup.job.config.DateHistogramGroupConfig

All Implemented Interfaces:

Validatable, org.elasticsearch.xcontent.ToXContent, org.elasticsearch.xcontent.ToXContentObject

Direct Known Subclasses:

DateHistogramGroupConfig.CalendarInterval, DateHistogramGroupConfig.FixedInterval

public class DateHistogramGroupConfig
extends Object
implements Validatable, org.elasticsearch.xcontent.ToXContentObject

The configuration object for the histograms in the rollup config { "groups": [ "date_histogram": { "field" : "foo", "interval" : "1d", "delay": "30d", "time_zone" : "EST" } ] }

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DateHistogramGroupConfig.CalendarInterval	CalendarInterval is a DateHistogramGroupConfig that uses calendar-aware intervals for rolling up data.
static class	DateHistogramGroupConfig.FixedInterval	FixedInterval is a DateHistogramGroupConfig that uses a fixed time interval for rolling up data.

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

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

Field Summary

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY_PARAMS

Fields inherited from interface org.elasticsearch.client.Validatable

EMPTY

Constructor Summary

Constructors

Constructor	Description
DateHistogramGroupConfig(String field, org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval interval)	Deprecated. Build a DateHistoConfig using DateHistogramGroupConfig.CalendarInterval or DateHistogramGroupConfig.FixedInterval instead
DateHistogramGroupConfig(String field, org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval interval, org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval delay, String timeZone)	Deprecated. Build a DateHistoConfig using DateHistogramGroupConfig.CalendarInterval or DateHistogramGroupConfig.FixedInterval instead

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object other)
static DateHistogramGroupConfig	fromXContent(org.elasticsearch.xcontent.XContentParser parser)
org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval	getDelay()	Get the time delay for this histogram
String	getField()	Get the date field
org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval	getInterval()	Get the date interval
String	getTimeZone()	Get the timezone to apply
int	hashCode()
org.elasticsearch.xcontent.XContentBuilder	toXContent(org.elasticsearch.xcontent.XContentBuilder builder, org.elasticsearch.xcontent.ToXContent.Params params)
Optional<ValidationException>	validate()	Perform validation.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.xcontent.ToXContentObject

isFragment

Constructor Details

DateHistogramGroupConfig

@Deprecated
public DateHistogramGroupConfig(String field,
 org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval interval)

Deprecated.

Build a DateHistoConfig using DateHistogramGroupConfig.CalendarInterval or DateHistogramGroupConfig.FixedInterval instead

Create a new DateHistogramGroupConfig using the given field and interval parameters.

Since:

7.2.0

DateHistogramGroupConfig

@Deprecated
public DateHistogramGroupConfig(String field,
 org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval interval,
 @Nullable
 org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval delay,
 @Nullable
 String timeZone)

Deprecated.

Build a DateHistoConfig using DateHistogramGroupConfig.CalendarInterval or DateHistogramGroupConfig.FixedInterval instead

Create a new DateHistogramGroupConfig using the given configuration parameters.

The field and interval are required to compute the date histogram for the rolled up documents. The delay is optional and can be set to null. It defines how long to wait before rolling up new documents. The timeZone is optional and can be set to null. When configured, the time zone value is resolved using (DateTimeZone.forID(String) and must match a time zone identifier provided by the Joda Time library.

Parameters:

field - the name of the date field to use for the date histogram (required)

interval - the interval to use for the date histogram (required)

delay - the time delay (optional)

timeZone - the id of time zone to use to calculate the date histogram (optional). When null, the UTC timezone is used.

Since:

7.2.0

Method Details

validate

public Optional<ValidationException> validate()

Description copied from interface: Validatable

Perform validation. This method does not have to be overridden in the event that no validation needs to be done, or the validation was done during object construction time. A ValidationException that is not null is assumed to contain validation errors and will be thrown.

Specified by:

validate in interface Validatable

Returns:

An Optional ValidationException that contains a list of validation errors.

getField

public String getField()

Get the date field

getInterval

public org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval getInterval()

Get the date interval

getDelay

public org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramInterval getDelay()

Get the time delay for this histogram

getTimeZone

public String getTimeZone()

Get the timezone to apply

toXContent

public org.elasticsearch.xcontent.XContentBuilder toXContent(org.elasticsearch.xcontent.XContentBuilder builder,
 org.elasticsearch.xcontent.ToXContent.Params params)
                                                      throws IOException

Specified by:

toXContent in interface org.elasticsearch.xcontent.ToXContent

Throws:

IOException

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

fromXContent

public static DateHistogramGroupConfig fromXContent(org.elasticsearch.xcontent.XContentParser parser)
                                             throws IOException

Throws:

IOException