mondrian.rolap.agg
Class AggregationManager

java.lang.Object
  mondrian.rolap.RolapAggregationManager
      mondrian.rolap.agg.AggregationManager

Direct Known Subclasses:

CountingAggregationManager

public class AggregationManager
extends RolapAggregationManager

RolapAggregationManager manages all Aggregations in the system. It is a singleton class.

Since:

30 August, 2001

Version:

$Id: //open/mondrian/src/main/mondrian/rolap/agg/AggregationManager.java#69 $

Author:

jhyde

Nested Class Summary

static class

AggregationManager.PinSetImpl Implementation of RolapAggregationManager.PinSet using a HashSet.

Nested classes/interfaces inherited from class mondrian.rolap.RolapAggregationManager

RolapAggregationManager.PinSet

Constructor Summary

AggregationManager()
Creates the AggregationManager.

Method Summary

RolapAggregationManager.PinSet	createPinSet() Creates a RolapAggregationManager.PinSet.
AggStar	findAgg(RolapStar star, BitKey levelBitKey, BitKey measureBitKey, boolean[] rollup) Finds an aggregate table in the given star which has the desired levels and measures.
Pair<String,List<SqlStatement.Type>>	generateSql(GroupingSetsList groupingSetsList, List<StarPredicate> compoundPredicateList) Generates the query to retrieve the cells for a list of segments.
Object	getCellFromCache(CellRequest request) Retrieves the value of a cell from the cache.
Object	getCellFromCache(CellRequest request, RolapAggregationManager.PinSet pinSet)
String	getDrillThroughSql(CellRequest request, StarPredicate starPrediateSlicer, boolean countOnly) Generates a SQL statement which will return the rows which contribute to this request.
org.apache.log4j.Logger	getLogger() Returns the log4j logger.
static AggregationManager	instance() Returns or creates the singleton.
void	loadAggregation(RolapStar.Measure[] measures, RolapStar.Column[] columns, AggregationKey aggregationKey, StarColumnPredicate[] predicates, RolapAggregationManager.PinSet pinnedSegments, GroupingSetsCollector groupingSetsCollector) Called by FastBatchingCellReader.loadAggregation where the RolapStar creates an Aggregation if needed.

Methods inherited from class mondrian.rolap.RolapAggregationManager

getCacheCellReader, getCacheControl, makeCacheRegion, makeDrillThroughRequest, makeRequest, makeRequest

Methods inherited from class java.lang.Object

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

Constructor Detail

AggregationManager

AggregationManager()

Creates the AggregationManager.

Method Detail

instance

public static AggregationManager instance()

Returns or creates the singleton.

getLogger

public final org.apache.log4j.Logger getLogger()

Returns the log4j logger.

Returns:

Logger

loadAggregation

public void loadAggregation(RolapStar.Measure[] measures,
                            RolapStar.Column[] columns,
                            AggregationKey aggregationKey,
                            StarColumnPredicate[] predicates,
                            RolapAggregationManager.PinSet pinnedSegments,
                            GroupingSetsCollector groupingSetsCollector)

Called by FastBatchingCellReader.loadAggregation where the RolapStar creates an Aggregation if needed.

Parameters:

measures - Measures to load

columns - this is the CellRequest's constrained columns

aggregationKey - this is the CellRequest's constraint key

predicates - Array of constraints on each column

pinnedSegments - Set of pinned segments

groupingSetsCollector - grouping sets collector

getCellFromCache

public Object getCellFromCache(CellRequest request)

Description copied from class: RolapAggregationManager

Retrieves the value of a cell from the cache.

Specified by:

getCellFromCache in class RolapAggregationManager

Parameters:

request - Cell request

Returns:

Cell value, or null if cell is not in any aggregation in cache, or Util.nullValue if cell's value is null

getCellFromCache

public Object getCellFromCache(CellRequest request,
                               RolapAggregationManager.PinSet pinSet)

Specified by:

getCellFromCache in class RolapAggregationManager

getDrillThroughSql

public String getDrillThroughSql(CellRequest request,
                                 StarPredicate starPrediateSlicer,
                                 boolean countOnly)

Description copied from class: RolapAggregationManager

Generates a SQL statement which will return the rows which contribute to this request.

Specified by:

getDrillThroughSql in class RolapAggregationManager

Parameters:

request - Cell request

starPrediateSlicer - A StarPredicate representing slicer positions that could not be represented by the CellRequest, or null if no additional predicate is necessary.

countOnly - If true, return a statment which returns only the count

Returns:

SQL statement

generateSql

public Pair<String,List<SqlStatement.Type>> generateSql(GroupingSetsList groupingSetsList,
                                                        List<StarPredicate> compoundPredicateList)

Generates the query to retrieve the cells for a list of segments. Called by Segment.load.

Returns:

A pair consisting of a SQL statement and a list of suggested types of columns

findAgg

public AggStar findAgg(RolapStar star,
                       BitKey levelBitKey,
                       BitKey measureBitKey,
                       boolean[] rollup)

Finds an aggregate table in the given star which has the desired levels and measures. Returns null if no aggregate table is suitable.

If there no aggregate is an exact match, returns a more granular aggregate which can be rolled up, and sets rollup to true. If one or more of the measures are distinct-count measures rollup is possible only in limited circumstances.

Parameters:

star - Star

levelBitKey - Set of levels

measureBitKey - Set of measures

rollup - Out parameter, is set to true if the aggregate is not an exact match

Returns:

An aggregate, or null if none is suitable.

createPinSet

public RolapAggregationManager.PinSet createPinSet()

Description copied from class: RolapAggregationManager

Creates a RolapAggregationManager.PinSet.

Specified by:

createPinSet in class RolapAggregationManager

Returns:

a new PinSet