org.apache.calcite.materialize

Class MaterializationService

java.lang.Object

org.apache.calcite.materialize.MaterializationService

public class MaterializationService
extends Object

Manages the collection of materialized tables known to the system, and the process by which they become valid and invalid.

Method Summary

Methods

Modifier and Type	Method and Description
CalciteSchema.TableEntry	checkValid(MaterializationKey key) Checks whether a materialization is valid, and if so, returns the table where the data are stored.
void	clear() De-registers all materialized tables in the system.
MaterializationKey	defineMaterialization(CalciteSchema schema, TileKey tileKey, String viewSql, List<String> viewSchemaPath, String suggestedTableName, boolean create) Defines a new materialization.
Pair<CalciteSchema.TableEntry,TileKey>	defineTile(Lattice lattice, ImmutableBitSet groupSet, List<Lattice.Measure> measureList, CalciteSchema schema, boolean create, boolean exact) Defines a tile.
static MaterializationService	instance() Returns the instance of the materialization service.
List<Prepare.Materialization>	query(CalciteSchema rootSchema) Gathers a list of all materialized tables known within a given root schema.
static void	setThreadLocal() Used by tests, to ensure that they see their own service.

Methods inherited from class java.lang.Object

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

Method Detail

defineMaterialization

public MaterializationKey defineMaterialization(CalciteSchema schema,
                                       TileKey tileKey,
                                       String viewSql,
                                       List<String> viewSchemaPath,
                                       String suggestedTableName,
                                       boolean create)

Defines a new materialization. Returns its key.

checkValid

public CalciteSchema.TableEntry checkValid(MaterializationKey key)

Checks whether a materialization is valid, and if so, returns the table where the data are stored.

defineTile

public Pair<CalciteSchema.TableEntry,TileKey> defineTile(Lattice lattice,
                                                ImmutableBitSet groupSet,
                                                List<Lattice.Measure> measureList,
                                                CalciteSchema schema,
                                                boolean create,
                                                boolean exact)

Defines a tile.

Setting the create flag to false prevents a materialization from being created if one does not exist. Critically, it is set to false during the recursive SQL that populates a materialization. Otherwise a materialization would try to create itself to populate itself!

query

public List<Prepare.Materialization> query(CalciteSchema rootSchema)

Gathers a list of all materialized tables known within a given root schema. (Each root schema defines a disconnected namespace, with no overlap with the current schema. Especially in a test run, the contents of two root schemas may look similar.)

clear

public void clear()

De-registers all materialized tables in the system.

setThreadLocal

public static void setThreadLocal()

Used by tests, to ensure that they see their own service.

instance

public static MaterializationService instance()

Returns the instance of the materialization service. Usually the global one, but returns a thread-local one during testing (when setThreadLocal() has been called by the current thread).