Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Configure the Mondrian Engine (

Purpose: is a configuration file referenced by the Pentaho Analysis (Mondrian) engine to determine performance and usability settings.

Location: /pentaho/server/biserver-ee/pentaho-solutions/system/mondrian/

Note: This section is specific to maximizing Mondrian performance with Pentaho Analyzer. For all available settings, see


One of the key performance goals for Analyzer is to push as many operations to the database as possible. This is particularly important when querying many high-cardinality dimensions because you want Mondrian to only process the combinations that make sense and not a huge cartesian product which is sparsely populated. Pay particular attention to the following engine properties:


Improves the performance of summary numbers such as ranks and running sums.


This is an essential property which enabes pushdown to the database so that Mondrian does not perform large cross joins in memory.


Particularly important for pushdown of Not In and Excludes filters.


This should be set to false to optimize Mondrian SQL generation given the MDX patterns generated by Analyzer. Analyzer uses non-empty cross joins to push down joins between high cardinality attributes to the database. If this property is set to false, there are many non-empty cross joins which would get evaluated by Mondrian instead because Mondrian pushes down the individual arguments such as dimension.members.


Used in conjunction with the mondrian.native.ExpandNonNative property. This should be set to as large as the underlying DB can support.


Allows pushdown of even more crossjoins by materializing the crossjoin inputs into IN lists. For example, a crossjoin whose inputs are MDX functions can first have their inputs evaluated to members and then convert the crossjoin into native evaluation.


Analyzer always generates dimension qualified members so no need to spend time searching for members on different dimensions.



In the event that pushdown cannot occur, this is the largest crossjoin size that Mondrian should try to process. Anything that exceeds this will likely send the CPU for a toss and result in long server hangs. If this limit is hit, Analyzer will present the user a nice warning suggesting options to simplify the report.

This is important for "Equals" filters because the UI will preserve the casing of filter values. If the user defines a filter on "John Doe", then the filter should only applies to "John Doe" and not "john doe"


This is important for saved reports because the user may build a report with a filter on 10 sales rep and after the next ETL, one of them is gone. The report should continue to run and return just the 9 remaining sales reps.


See mondrian.olap.ignoreInvalidMembers


Similar to mondrian.result.limit except for controlling limits on aggregate evaluation.


This is required for sorting members in a dimension A->Z or Z->A. This property fixes a bug in Mondrian but was added for backward compatibility.


The best way to understand this property is via an example. Suppose you want to see quota attainment for your sales reps which is computed as Booked Deals / Quota. Some reps may not have quotas and so quota attainment is either infinity or null. By treating divide by null as infinity, Mondrian will return these sales reps in the report. Otherwise, if divide by null evaluates to null, then Mondrian will filter those reps out (due to the NON EMPTY).