public class ARQ extends Object
Modifier and Type | Field and Description |
---|---|
static boolean |
allowDuplicateSelectColumns
Indicate whether duplicate select and groupby variables are allowed.
|
static String |
arqIRI
IRI for ARQ
|
static String |
arqParamNS
Root of ARQ-defined parameter names
|
static String |
arqSymbolPrefix
Prefix for ARQ-defined parameter names
|
static String |
BUILD_DATE
The date and time at which this release was built
|
static Symbol |
constantBNodeLabels
Controls bNode labels as <_:...> or not -
that is a pseudo URIs.
|
static Symbol |
enableExecutionTimeLogging
Enable logging of execution timing.
|
static Symbol |
enablePropertyFunctions
Enable built-in property functions - also called "magic properties".
|
static Symbol |
extensionValueTypes
Expression evaluation without extension types (e.g.
|
static Symbol |
fixupUndefinedPrefixes
If set to true, the parsers will convert undefined prefixes to a URI
according to the fixup function
RiotLib.fixupPrefixes . |
static Symbol |
generateToList
Generate the ToList operation in the algebra (as ARQ is stream based, ToList is a non-op).
|
static Symbol |
hideNonDistiguishedVariables
Context key to control hiding non-distinuished variables
|
static Symbol |
inputGraphBNodeLabels
If true, XML result sets will use the bNode label in the result set itself.
|
static Symbol |
javaRegex
Symbol to name java.util.regex regular expression engine
|
static String |
logExecName
Name of the execution logger
|
static String |
logHttpRequestName
Name of the logger for remote HTTP requests
|
static String |
logInfoName
Name of the information logger
|
static String |
NAME
The product name
|
static Symbol |
optDistinctToReduced
Context key controlling whether a DISTINCT-ORDER BY query is done by replacing the distinct with a reduced.
|
static Symbol |
optExprConstantFolding
Context key controlling whether the standard optimizer applies constant folding to expressions
|
static Symbol |
optFilterConjunction
Context key controlling whether the standard optimizer applies
optimizations to conjunctions (&&) in filters.
|
static Symbol |
optFilterDisjunction
Context key controlling whether the standard optimizer applies
optimizations to disjunctions (||) in filters.
|
static Symbol |
optFilterEquality
Context key controlling whether the standard optimizer applies
optimizations to equalities in FILTERs.
|
static Symbol |
optFilterExpandOneOf
Context key controlling whether the standard optimizer applies
optimizations to IN and NOT IN.
|
static Symbol |
optFilterImplicitJoin
Context key controlling whether the standard optimizer applies optimizations to implicit joins in FILTERs.
|
static Symbol |
optFilterInequality
Context key controlling whether the standard optimizer applies
optimizations to inequalities in FILTERs
This optimization is conservative - it does not take place if
there is a potential risk of changing query semantics
|
static Symbol |
optFilterPlacement
Context key controlling whether the main query engine moves filters to the "best" place.
|
static Symbol |
optFilterPlacementBGP
Context key controlling whether to do filter placement within BGP and quad blocks.
|
static Symbol |
optFilterPlacementConservative
Context key controlling whether the main query engine moves filters to the "best" place using
the more limited and conservative strategy which does not place as many filters
Must be explicitly set "true" to operate.
|
static Symbol |
optimization
Context key controlling whether the main query engine applies the
default optimization transformations.
|
static Symbol |
optImplicitLeftJoin
Context key controlling whether the standard optimizer applies optimizations to implicit left joins.
|
static Symbol |
optIndexJoinStrategy
Context key controlling whether the standard optimizer applies optimizations to the evaluation
of joins to favour index joins wherever possible
|
static Symbol |
optInlineAssignments
Context key controlling whether the standard optimizer applies optimizations where by some
assignments may be eliminated/inlined into the operators where their values are used only once
|
static Symbol |
optInlineAssignmentsAggressive
Context key controlling whether the standard optimizer aggressively inlines assignments whose
values are used only once into operators where those expressions may be evaluated multiple times e.g.
|
static Symbol |
optMergeBGPs
Context key controlling whether the standard optimizater applies optimizations to joined BGPs to
merge them into single BGPs.
|
static Symbol |
optMergeExtends
Context key controlling whether the standard optimizater applies the optimization
to combine stacks of (extend) into one compound operation.
|
static Symbol |
optOrderByDistinctApplication
Context key controlling whether a DISTINCT-ORDER BY query is done by applying the ORDER BY after the DISTINCT
when default SPARQL semantics usually mean ORDER BY applies before DISTINCT.
|
static Symbol |
optPathFlatten
Context key controlling whether the main query engine flattens simple paths
(e.g.
|
static Symbol |
optPromoteTableEmpty
Context key controlling whether the standard optimizer applies table empty promotion
|
static Symbol |
optReorderBGP
Context key controlling whether the standard optimizater applies the optimization
to reorder basic graph patterns.
|
static Symbol |
optTopNSorting
Context key controlling whether an ORDER BY-LIMIT query is done avoiding total sort using an heap.
|
static Symbol |
outputGraphBNodeLabels
If true, XML result sets written will contain the graph bNode label
See also inputGraphBNodeLabels
|
static String |
PATH
The root package name for ARQ
|
static Symbol |
propertyFunctions
Context key controlling whether the main query engine processes property functions.
|
static Symbol |
queryTimeout
Set timeout.
|
static Symbol |
regexImpl
Determine which regular expression system to use.
|
static Symbol |
serviceAllowed
Control whether SERVICE processing is allowed.
|
static Symbol |
serviceParams
Use this Symbol to allow passing additional query parameters to a
SERVICE <IRI> call.
|
static Symbol |
spillToDiskThreshold
A Long value that specifies the number of bindings (or triples for CONSTRUCT queries) to be stored in memory by sort
operations or hash tables before switching to temporary disk files.
|
static Symbol |
stageGenerator
Context key for StageBuilder used in BGP compilation
|
static Symbol |
strictSPARQL
Stick exactly to the spec.
|
static Symbol |
symJavaScriptFunctions
Context symbol for JavaScript functions as a string value which is evaluated.
|
static Symbol |
symJavaScriptLibFile
Context symbol for JavaScript library of functions defined in a file.
|
static Symbol |
symLogExec
Symbol to enable logging of execution.
|
static Symbol |
topNSortingThreshold
Threshold for doing a top N sort for ORDER-LIMIT.
|
static Symbol |
useSAX
Use the SAX parser for XML result sets.
|
static String |
VERSION
The full name of the current ARQ version
|
static Symbol |
xercesRegex
Symbol to name the Xerces-J regular expression engine
|
Constructor and Description |
---|
ARQ() |
Modifier and Type | Method and Description |
---|---|
static void |
enableBlankNodeResultLabels()
Turn on processing of blank node labels in queries
|
static void |
enableBlankNodeResultLabels(boolean val)
Turn on/off processing of blank node labels in queries
|
static void |
enableOptimizer(boolean state)
Globally switch the default optimizer on and off :
Note that storage subsystems may also be applying
separately controlled optimizations.
|
static void |
enableOptimizer(Context context,
boolean state)
Switch the default optimizer on and off for a specific Context.
|
static Context |
getContext() |
static org.slf4j.Logger |
getExecLogger()
The execution logger
|
static Explain.InfoLevel |
getExecutionLogging()
Get the currently global execution logging setting
|
static org.slf4j.Logger |
getHttpRequestLogger()
The HTTP Request logger
|
static org.slf4j.Logger |
getInfoLogger()
The information logger
|
static void |
init() |
static boolean |
isFalse(Symbol symbol) |
static boolean |
isFalseOrUndef(Symbol symbol) |
static boolean |
isStrictMode() |
static boolean |
isTrue(Symbol symbol) |
static boolean |
isTrueOrUndef(Symbol symbol) |
static void |
set(Symbol symbol,
boolean value) |
static void |
setExecutionLogging(Explain.InfoLevel infoLevel)
Set execution logging - logging is to logger "org.apache.jena.arq.exec" at level INFO.
|
static void |
setFalse(Symbol symbol) |
static void |
setNormalMode()
Set normal mode, including expression evaluation
|
static void |
setNormalMode(Context context)
Explicitly set the values for normal operation.
|
static void |
setStrictMode()
Set strict mode, including expression evaluation
|
static void |
setStrictMode(Context context)
Set strict mode for a given Context.
|
static void |
setTrue(Symbol symbol) |
static void |
unset(Symbol symbol) |
public static final String logExecName
public static final String logInfoName
public static final String logHttpRequestName
public static final Symbol symLogExec
public static final String arqIRI
public static final String arqParamNS
public static final String arqSymbolPrefix
public static final Symbol strictSPARQL
public static final Symbol constantBNodeLabels
public static final Symbol enablePropertyFunctions
public static final Symbol enableExecutionTimeLogging
public static final Symbol outputGraphBNodeLabels
public static final Symbol inputGraphBNodeLabels
public static final Symbol queryTimeout
public static final Symbol stageGenerator
public static final Symbol hideNonDistiguishedVariables
public static final Symbol useSAX
public static final boolean allowDuplicateSelectColumns
public static final Symbol regexImpl
public static final Symbol javaRegex
public static final Symbol xercesRegex
public static final Symbol serviceParams
Service
public static final Symbol serviceAllowed
public static final Symbol fixupUndefinedPrefixes
RiotLib.fixupPrefixes
.
Normally, unset (which equates to false).RiotLib.isPrefixIRI(java.lang.String)
public static final Symbol spillToDiskThreshold
public static final Symbol optimization
public static final Symbol optPathFlatten
Default is "true"
public static final Symbol optFilterPlacement
public static final Symbol optFilterPlacementBGP
public static final Symbol optFilterPlacementConservative
optFilterPlacement
must also be active (which it is by default).optFilterPlacement
public static final Symbol optTopNSorting
public static final Symbol topNSortingThreshold
Number
.public static final Symbol optDistinctToReduced
public static final Symbol optOrderByDistinctApplication
optDistinctToReduced
optimization.
See TransformOrderByDistinctApplication
for more discussion on exactly when this may apply
public static final Symbol optFilterEquality
public static final Symbol optFilterInequality
public static final Symbol optFilterImplicitJoin
public static final Symbol optImplicitLeftJoin
public static final Symbol optExprConstantFolding
By default, this transformation is applied.
public static final Symbol optFilterConjunction
By default, this transformation is applied.
public static final Symbol optFilterExpandOneOf
By default, this transformation is applied.
public static final Symbol optFilterDisjunction
By default, this transformation is applied.
public static final Symbol optPromoteTableEmpty
public static final Symbol optIndexJoinStrategy
public static final Symbol optInlineAssignments
By default, this transformation is not applied.
public static final Symbol optInlineAssignmentsAggressive
This is modifier to optInlineAssignments
.
public static final Symbol optMergeBGPs
By default, this transformation is applied.
public static final Symbol optMergeExtends
By default, this transformation is applied.
public static final Symbol optReorderBGP
By default, this transformation is NOT applied. It is left to the specific engines to decide.
public static final Symbol propertyFunctions
By default, this is applied.
public static final Symbol extensionValueTypes
public static Symbol symJavaScriptFunctions
public static Symbol symJavaScriptLibFile
public static final Symbol generateToList
public static final String PATH
public static final String NAME
public static final String VERSION
public static final String BUILD_DATE
public static org.slf4j.Logger getExecLogger()
public static org.slf4j.Logger getInfoLogger()
public static org.slf4j.Logger getHttpRequestLogger()
public static Explain.InfoLevel getExecutionLogging()
public static void setExecutionLogging(Explain.InfoLevel infoLevel)
public static void enableBlankNodeResultLabels()
public static void enableBlankNodeResultLabels(boolean val)
public static void enableOptimizer(boolean state)
public static void enableOptimizer(Context context, boolean state)
public static void setStrictMode()
public static void setStrictMode(Context context)
public static boolean isStrictMode()
public static void setNormalMode()
public static void setNormalMode(Context context)
public static void init()
public static Context getContext()
public static void set(Symbol symbol, boolean value)
public static void setTrue(Symbol symbol)
public static void setFalse(Symbol symbol)
public static void unset(Symbol symbol)
public static boolean isTrue(Symbol symbol)
public static boolean isFalse(Symbol symbol)
public static boolean isTrueOrUndef(Symbol symbol)
public static boolean isFalseOrUndef(Symbol symbol)
Licenced under the Apache License, Version 2.0