public abstract class CalciteTrace
extends java.lang.Object
tracers
used within
org.apache.calcite class libraries.
Please ensure that every tracer used in org.apache.calcite is added to
this class as a public static final member called
componentTracer
. For example, getPlannerTracer()
is the
tracer used by all classes which take part in the query planning process.
The javadoc in this file is the primary source of information on what tracers are available, so the javadoc against each tracer member must be an up-to-date description of what that tracer does.
In the class where the tracer is used, create a private (or
perhaps protected) static final member called
tracer
.
Modifier and Type | Field and Description |
---|---|
private static java.lang.ThreadLocal<Function2<java.lang.Void,java.io.File,java.lang.String>> |
DYNAMIC_HANDLER |
static org.slf4j.Logger |
PARSER_LOGGER
The "org.apache.calcite.sql.parser" tracer reports parser events in
SqlParser and other classes at DEBUG. |
Constructor and Description |
---|
CalciteTrace() |
Modifier and Type | Method and Description |
---|---|
static java.lang.ThreadLocal<Function2<java.lang.Void,java.io.File,java.lang.String>> |
getDynamicHandler()
Thread-local handler that is called with dynamically generated Java code.
|
static org.slf4j.Logger |
getParserTracer()
The "org.apache.calcite.sql.parser" tracer reports parse events.
|
static org.slf4j.Logger |
getPlannerTracer()
The "org.apache.calcite.plan.RelOptPlanner" tracer prints the query
optimization process.
|
static org.slf4j.Logger |
getRelImplementorTracer()
The "org.apache.calcite.rel.RelImplementorImpl" tracer reports when
expressions are bound to variables (DEBUG, formerly FINE)
|
static org.slf4j.Logger |
getSqlTimingTracer()
The tracer "org.apache.calcite.sql.timing" traces timing for
various stages of query processing.
|
static org.slf4j.Logger |
getSqlToRelTracer()
The "org.apache.calcite.sql2rel" tracer reports parse events.
|
static org.slf4j.Logger |
getStatementTracer()
The "org.apache.calcite.prepare.Prepare" tracer prints the generated
program at DEBUG (formerly, FINE) or higher.
|
public static final org.slf4j.Logger PARSER_LOGGER
SqlParser
and other classes at DEBUG.private static final java.lang.ThreadLocal<Function2<java.lang.Void,java.io.File,java.lang.String>> DYNAMIC_HANDLER
public static org.slf4j.Logger getPlannerTracer()
Levels:
Logger.debug(String)
(formerly FINE) prints rules as they fire;
Logger.trace(String)
(formerly FINER) prints and validates the whole expression
pool and rule queue as each rule fires;
Logger.trace(String)
(formerly FINEST) also prints finer details like rule
importances.
public static org.slf4j.Logger getStatementTracer()
public static org.slf4j.Logger getRelImplementorTracer()
public static org.slf4j.Logger getSqlTimingTracer()
CalciteTimingTracer
public static org.slf4j.Logger getParserTracer()
public static org.slf4j.Logger getSqlToRelTracer()
public static java.lang.ThreadLocal<Function2<java.lang.Void,java.io.File,java.lang.String>> getDynamicHandler()
Copyright © 2012–2019 The Apache Software Foundation. All rights reserved.