org.apache.jackrabbit.oak.query

Class QueryEngineSettings

java.lang.Object

org.apache.jackrabbit.oak.query.QueryEngineSettings

All Implemented Interfaces:

QueryEngineSettingsMBean, QueryLimits

public class QueryEngineSettings
extends java.lang.Object
implements QueryEngineSettingsMBean, QueryLimits

Settings of the query engine.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_FAST_QUERY_SIZE
static long	DEFAULT_QUERY_LIMIT_IN_MEMORY
static long	DEFAULT_QUERY_LIMIT_READS
static java.lang.String	OAK_QUERY_FAIL_TRAVERSAL
static java.lang.String	OAK_QUERY_LIMIT_IN_MEMORY
static java.lang.String	OAK_QUERY_LIMIT_READS
static java.lang.String	SQL2_OPTIMISATION_FLAG the flag used to turn on/off the optimisations on top of the org.apache.jackrabbit.oak.query.Query object.
static java.lang.String	SQL2_OPTIMISATION_FLAG_2
static boolean	SQL2_OPTIMIZATION_2

Fields inherited from interface org.apache.jackrabbit.oak.api.jmx.QueryEngineSettingsMBean

TYPE

Constructor Summary

Constructors

Constructor and Description
QueryEngineSettings()
QueryEngineSettings(StatisticsProvider statisticsProvider)

Method Summary

Modifier and Type	Method and Description
boolean	getFailTraversal() Whether queries that don't use an index will fail (throw an exception).
boolean	getFullTextComparisonWithoutIndex()
@NotNull java.lang.String[]	getIgnoredClassNamesInCallTrace() Retrieve the java package names / full qualified class names which should be ignored when finding the class starting a query
long	getLimitInMemory() Get the limit on how many nodes a query may read at most into memory, for "order by" and "distinct" queries.
long	getLimitReads() Get the limit on how many nodes a query may read at most (raw read operations, including skipped nodes).
long	getQueryLengthErrorLimit()
long	getQueryLengthWarnLimit()
QueryStatsMBean	getQueryStats()
QueryStatsReporter	getQueryStatsReporter()
QueryValidator	getQueryValidator()
java.lang.String	getQueryValidatorJson()
StatisticsProvider	getStatisticsProvider()
java.lang.String	getStrictPathRestriction() Whether Path restrictions are enabled while figuring out index plan
boolean	isFastQuerySize() Whether the query result size should return an estimation for large queries.
boolean	isSql2Optimisation()
void	setFailTraversal(boolean failTraversal) Set whether queries that don't use an index will fail (throw an exception).
void	setFastQuerySize(boolean fastQuerySize)
void	setFullTextComparisonWithoutIndex(boolean fullTextComparisonWithoutIndex)
void	setIgnoredClassNamesInCallTrace(@NotNull java.lang.String[] packageNames) Set or remove java package/class names which are ignored from finding the invoking class for queries.
void	setLimitInMemory(long limitInMemory) Change the limit.
void	setLimitReads(long limitReads) Change the limit.
void	setQueryValidatorPattern(java.lang.String key, java.lang.String pattern, java.lang.String comment, boolean failQuery) Set or remove a query validator pattern.
void	setStrictPathRestriction(java.lang.String strictPathRestriction) Whether path restrictions of indexes (excludedPaths / includedPaths) are taken into account during query execution, for Lucene indexes.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

SQL2_OPTIMISATION_FLAG

public static final java.lang.String SQL2_OPTIMISATION_FLAG

the flag used to turn on/off the optimisations on top of the org.apache.jackrabbit.oak.query.Query object. -Doak.query.sql2optimisation

See Also:

Constant Field Values

SQL2_OPTIMISATION_FLAG_2

public static final java.lang.String SQL2_OPTIMISATION_FLAG_2

See Also:

Constant Field Values

SQL2_OPTIMIZATION_2

public static final boolean SQL2_OPTIMIZATION_2

OAK_QUERY_LIMIT_IN_MEMORY

public static final java.lang.String OAK_QUERY_LIMIT_IN_MEMORY

See Also:

Constant Field Values

DEFAULT_QUERY_LIMIT_IN_MEMORY

public static final long DEFAULT_QUERY_LIMIT_IN_MEMORY

OAK_QUERY_LIMIT_READS

public static final java.lang.String OAK_QUERY_LIMIT_READS

See Also:

Constant Field Values

DEFAULT_QUERY_LIMIT_READS

public static final long DEFAULT_QUERY_LIMIT_READS

OAK_QUERY_FAIL_TRAVERSAL

public static final java.lang.String OAK_QUERY_FAIL_TRAVERSAL

See Also:

Constant Field Values

DEFAULT_FAST_QUERY_SIZE

public static final boolean DEFAULT_FAST_QUERY_SIZE

Constructor Detail

QueryEngineSettings

public QueryEngineSettings()

QueryEngineSettings

public QueryEngineSettings(StatisticsProvider statisticsProvider)

Method Detail

getQueryLengthWarnLimit

public long getQueryLengthWarnLimit()

getQueryLengthErrorLimit

public long getQueryLengthErrorLimit()

getLimitInMemory

public long getLimitInMemory()

Description copied from interface: QueryEngineSettingsMBean

Get the limit on how many nodes a query may read at most into memory, for "order by" and "distinct" queries. If this limit is exceeded, the query throws an exception.

Specified by:

getLimitInMemory in interface QueryEngineSettingsMBean

Specified by:

getLimitInMemory in interface QueryLimits

Returns:

the limit

setLimitInMemory

public void setLimitInMemory(long limitInMemory)

Description copied from interface: QueryEngineSettingsMBean

Change the limit.

Specified by:

setLimitInMemory in interface QueryEngineSettingsMBean

Parameters:

limitInMemory - the new limit

getLimitReads

public long getLimitReads()

Description copied from interface: QueryEngineSettingsMBean

Get the limit on how many nodes a query may read at most (raw read operations, including skipped nodes). If this limit is exceeded, the query throws an exception.

Specified by:

getLimitReads in interface QueryEngineSettingsMBean

Specified by:

getLimitReads in interface QueryLimits

Returns:

the limit

setLimitReads

public void setLimitReads(long limitReads)

Description copied from interface: QueryEngineSettingsMBean

Change the limit.

Specified by:

setLimitReads in interface QueryEngineSettingsMBean

Parameters:

limitReads - the new limit

getFailTraversal

public boolean getFailTraversal()

Description copied from interface: QueryEngineSettingsMBean

Whether queries that don't use an index will fail (throw an exception). The default is false.

Specified by:

getFailTraversal in interface QueryEngineSettingsMBean

Specified by:

getFailTraversal in interface QueryLimits

Returns:

true if they fail

setFailTraversal

public void setFailTraversal(boolean failTraversal)

Description copied from interface: QueryEngineSettingsMBean

Set whether queries that don't use an index will fail (throw an exception).

Specified by:

setFailTraversal in interface QueryEngineSettingsMBean

Parameters:

failTraversal - the new value for this setting

isFastQuerySize

public boolean isFastQuerySize()

Description copied from interface: QueryEngineSettingsMBean

Whether the query result size should return an estimation for large queries.

Specified by:

isFastQuerySize in interface QueryEngineSettingsMBean

Returns:

true if enabled

setFastQuerySize

public void setFastQuerySize(boolean fastQuerySize)

Specified by:

setFastQuerySize in interface QueryEngineSettingsMBean

getStrictPathRestriction

public java.lang.String getStrictPathRestriction()

Description copied from interface: QueryEngineSettingsMBean

Whether Path restrictions are enabled while figuring out index plan

Specified by:

getStrictPathRestriction in interface QueryEngineSettingsMBean

Specified by:

getStrictPathRestriction in interface QueryLimits

Returns:

true if enabled

setStrictPathRestriction

public void setStrictPathRestriction(java.lang.String strictPathRestriction)

Description copied from interface: QueryEngineSettingsMBean

Whether path restrictions of indexes (excludedPaths / includedPaths) are taken into account during query execution, for Lucene indexes. When enabled, only indexes are considered if the index path restriction is compatible with the query path restrictions. When disabled, only the queryPaths of the index is taken into account.

Specified by:

setStrictPathRestriction in interface QueryEngineSettingsMBean

Parameters:

strictPathRestriction - Set path restriction: Expected value is either of ENABLE/DISABLE/WARN ENABLE: enable path restriction- Index won't be used if index definition path restrictions are not compatible with query's path restriction DISABLE: path restrictions are not taken into account while querying WARN: path restrictions are not taken into account but a warning will be logged if query path restrictions are not compatible with index path restrictions

setFullTextComparisonWithoutIndex

public void setFullTextComparisonWithoutIndex(boolean fullTextComparisonWithoutIndex)

getFullTextComparisonWithoutIndex

public boolean getFullTextComparisonWithoutIndex()

Specified by:

getFullTextComparisonWithoutIndex in interface QueryLimits

isSql2Optimisation

public boolean isSql2Optimisation()

getQueryStats

public QueryStatsMBean getQueryStats()

getQueryStatsReporter

public QueryStatsReporter getQueryStatsReporter()

getStatisticsProvider

public StatisticsProvider getStatisticsProvider()

setQueryValidatorPattern

public void setQueryValidatorPattern(java.lang.String key,
                                     java.lang.String pattern,
                                     java.lang.String comment,
                                     boolean failQuery)

Description copied from interface: QueryEngineSettingsMBean

Set or remove a query validator pattern.

Specified by:

setQueryValidatorPattern in interface QueryEngineSettingsMBean

Parameters:

key - the key

pattern - the regular expression pattern (empty to remove the pattern)

comment - a comment

failQuery - whether matching queries should fail (true) or just log a warning (false)

getQueryValidatorJson

public java.lang.String getQueryValidatorJson()

Specified by:

getQueryValidatorJson in interface QueryEngineSettingsMBean

getQueryValidator

public QueryValidator getQueryValidator()

setIgnoredClassNamesInCallTrace

public void setIgnoredClassNamesInCallTrace(@NotNull
                                            @NotNull java.lang.String[] packageNames)

Description copied from interface: QueryEngineSettingsMBean

Set or remove java package/class names which are ignored from finding the invoking class for queries. It can be either Java package names or fully-qualified class names (package + class name).

Specified by:

setIgnoredClassNamesInCallTrace in interface QueryEngineSettingsMBean

Parameters:

packageNames - the class names to be ignored.

getIgnoredClassNamesInCallTrace

@NotNull
public @NotNull java.lang.String[] getIgnoredClassNamesInCallTrace()

Description copied from interface: QueryLimits

Retrieve the java package names / full qualified class names which should be ignored when finding the class starting a query

Specified by:

getIgnoredClassNamesInCallTrace in interface QueryEngineSettingsMBean

Specified by:

getIgnoredClassNamesInCallTrace in interface QueryLimits

Returns:

the name of the packages / full qualified class names

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object