com.yahoo.bard.webservice.data.volatility

Interface VolatileIntervalsService

All Known Implementing Classes:

DefaultingVolatileIntervalsService

public interface VolatileIntervalsService

A Volatile Intervals Service determines which requested interval buckets are volatile on a query. Volatile intervals are intervals which may still not be finalized, and thus should not be cached. The normal use case for this is data which is being ingested via real time ingestion, and thus which will be replaced later by new historical segments.

Method Summary

Modifier and Type	Method and Description
default SimplifiedIntervalList	getVolatileIntervals(DruidAggregationQuery<?> query, PhysicalTable factSource) Deprecated. Exists solely for backwards compatibility. getVolatileIntervals(Granularity, List, PhysicalTable) should be used instead
SimplifiedIntervalList	getVolatileIntervals(Granularity granularity, List<org.joda.time.Interval> intervals, PhysicalTable factSource) Retrieve a simplified sublist of the given intervals aligned to the specified time buckets and that are partially or fully volatile.

Method Detail

getVolatileIntervals

SimplifiedIntervalList getVolatileIntervals(Granularity granularity,
                                            List<org.joda.time.Interval> intervals,
                                            PhysicalTable factSource)

Retrieve a simplified sublist of the given intervals aligned to the specified time buckets and that are partially or fully volatile. Volatile intervals should not be cached (in the same way that partial intervals are not cached) but are returned to the user (which partial intervals are typically not). Volatile intervals will typically abut or overlap incomplete data because they are on the forward edge of ingestion.

Parameters:

granularity - The granularity at which to check for volatility

intervals - The intervals that may contain a volatile sublist

factSource - The fact source table whose intervals are being retrieved

Returns:

A simplified interval list of volatile intervals

getVolatileIntervals

@Deprecated
default SimplifiedIntervalList getVolatileIntervals(DruidAggregationQuery<?> query,
                                                                PhysicalTable factSource)

Deprecated. Exists solely for backwards compatibility. getVolatileIntervals(Granularity, List, PhysicalTable) should be used instead

Retrieve a simplified list of intervals aligned to the time buckets of the query which are partially or fully volatile.

Parameters:

query - The query whose time bucketed intervals will be checked for volatility

factSource - The fact source table whose intervals are being retrieved

Returns:

A simplified interval list of volatile intervals