| Modifier and Type | Field | Description |
|---|---|---|
private java.lang.StringBuilder |
_buffer |
| Constructor | Description |
|---|---|
DefaultOptTrace() |
Make a DefaultOptTrace
|
| Modifier and Type | Method | Description |
|---|---|---|
private void |
appendTraceString(java.lang.String traceString) |
Append a string to the optimizer trace
|
void |
printToWriter(java.io.PrintWriter out) |
Print the trace so far.
|
private java.lang.String |
reportConglomerateDescriptor(ConglomerateDescriptor cd) |
|
private java.lang.String |
reportCostForTable(java.lang.Object cost,
int tableNumber) |
|
private java.lang.String |
reportCostIncluding(java.lang.String selectivityType,
CostEstimate cost,
int tableNumber) |
|
private java.lang.String |
reportJoinOrder(java.lang.String prefix,
boolean addJoinOrderNumber,
int joinOrderNumber,
int joinPosition,
int[] joinOrder,
JBitSet assignedTableMap) |
|
void |
traceAddingUnorderedOptimizable(int predicateCount) |
Say that we're adding an unordered optimizable.
|
void |
traceChangingAccessPathForTable(int tableNumber) |
Say that we're considering a different access path for a table.
|
void |
traceCheapestPlanSoFar(int planType,
CostEstimate currentCost) |
Report the cost of the cheapest plan so far.
|
void |
traceCompleteJoinOrder() |
Say that we have a complete join order.
|
void |
traceCompositeSelectivityFromStatistics(double statCompositeSelectivity) |
Report the selectivity calculated from SYSSTATISTICS.
|
void |
traceConsideringConglomerate(ConglomerateDescriptor cd,
int tableNumber) |
Report that we are considering a conglomerate for a table.
|
void |
traceConsideringJoinStrategy(JoinStrategy js,
int tableNumber) |
Say that we're considering a particular join strategy on a particular table.
|
void |
traceConstantStartStopPositions() |
Say that we're setting the lock mode to MODE_RECORD because the start and stop positions are all constant.
|
void |
traceCostIncludingCompositeSelectivityFromStats(CostEstimate cost,
int tableNumber) |
Report the cost based on selectivities coming out of SYSSTATISTICS.
|
void |
traceCostIncludingExtra1stColumnSelectivity(CostEstimate cost,
int tableNumber) |
Report the cost of a scan given the selectivity of an extra first column.
|
void |
traceCostIncludingExtraNonQualifierSelectivity(CostEstimate cost,
int tableNumber) |
Report the cost if we include an extra non-qualifier.
|
void |
traceCostIncludingExtraQualifierSelectivity(CostEstimate cost,
int tableNumber) |
Report the cost if we include an extra qualifier.
|
void |
traceCostIncludingExtraStartStop(CostEstimate cost,
int tableNumber) |
Report the cost if we include an extra start/stop.
|
void |
traceCostIncludingStatsForIndex(CostEstimate cost,
int tableNumber) |
Report the cost based on index statistics.
|
void |
traceCostOfConglomerateScan(int tableNumber,
ConglomerateDescriptor cd,
CostEstimate costEstimate,
int numExtraFirstColumnPreds,
double extraFirstColumnSelectivity,
int numExtraStartStopPreds,
double extraStartStopSelectivity,
int startStopPredCount,
double statStartStopSelectivity,
int numExtraQualifiers,
double extraQualifierSelectivity,
int numExtraNonQualifiers,
double extraNonQualifierSelectivity) |
Report the cost of a conglomerate scan.
|
void |
traceCostOfNoncoveringIndex(CostEstimate cost,
int tableNumber) |
Report the cost of using a non-covering index.
|
void |
traceCostOfNScans(int tableNumber,
double rowCount,
CostEstimate cost) |
Report the cost of scanning a table a certain number of times
|
void |
traceCostWithoutSortAvoidance(CostEstimate currentCost) |
Report the cost without a sort.
|
void |
traceCostWithSortAvoidance(CostEstimate currentSortAvoidanceCost) |
Report the cost with sort avoidance.
|
void |
traceCurrentPlanAvoidsSort(CostEstimate bestCost,
CostEstimate currentSortAvoidanceCost) |
Say that the current plan avoids a sort.
|
void |
traceEndQueryBlock() |
End tracing the optimization of a query block.
|
void |
traceEstimatingCostOfConglomerate(ConglomerateDescriptor cd,
int tableNumber) |
Report the cost of using a particular conglomerate to scan a table.
|
void |
traceHashKeyColumns(int[] hashKeyColumns) |
Report the columns being traced
|
void |
traceIllegalUserJoinOrder() |
Say that the user specified an impossible join order.
|
void |
traceJoinOrderConsideration(int joinPosition,
int[] proposedJoinOrder,
JBitSet assignedTableMap) |
Say that we're considering a join order.
|
void |
traceLookingForSpecifiedIndex(java.lang.String indexName,
int tableNumber) |
Say that we're looking for an index specified by optimizer hints.
|
void |
traceModifyingAccessPaths(int optimizerID) |
Say that we're modifying access paths.
|
void |
traceNextAccessPath(java.lang.String baseTable,
int predicateCount) |
Report that we are advancing to the next access path for the table.
|
void |
traceNoBestPlan() |
Say that we couldn't find a best plan.
|
void |
traceNoMoreConglomerates(int tableNumber) |
Say that we have exhausted the conglomerate possibilities for a table.
|
void |
traceNonCoveringIndexCost(double cost,
int tableNumber) |
Say that we're considering a non-covering index.
|
void |
traceNoStartStopPosition() |
Say that we're setting the lock mode to MODE_TABLE because there is no start/stop position.
|
void |
traceOptimizingJoinNode() |
Say that we're starting to optimize a join node
|
void |
traceRememberingBestAccessPath(AccessPath accessPath,
int tableNumber,
int planType) |
Report that we've found a best access path.
|
void |
traceRememberingBestAccessPathSubstring(AccessPath ap,
int tableNumber) |
Report the best access path for the table so far.
|
void |
traceRememberingBestJoinOrder(int joinPosition,
int[] bestJoinOrder,
int planType,
CostEstimate planCost,
JBitSet assignedTableMap) |
Say that we are remembering the current plan as the best join order so far.
|
void |
traceRememberingBestSortAvoidanceAccessPathSubstring(AccessPath ap,
int tableNumber) |
Report the best sort-avoiding access path for this table so far.
|
void |
traceRememberingBestUnknownAccessPathSubstring(AccessPath ap,
int tableNumber) |
Report an optimizer failure, e.g., while optimizing an outer join
|
void |
traceRememberingJoinStrategy(JoinStrategy joinStrategy,
int tableNumber) |
Say that we've found a new best join strategy for the table.
|
void |
traceScanningHeapWithUniqueKey() |
Say that we're considering scanning a heap even though we have a unique key match.
|
void |
traceShortCircuiting(boolean timeExceeded,
Optimizable thisOpt,
int joinPosition) |
Say that we short-circuited a join order.
|
void |
traceSingleMatchedRowCost(double cost,
int tableNumber) |
Report the cost of a scan which will match exactly one row.
|
void |
traceSkipHashJoinNoHashKeys() |
Say we won't consider a hash join because there are no hash key columns.
|
void |
traceSkippingBecauseTooMuchMemory(int maxMemoryPerTable) |
Say that we are skipping a plan because it consumes too much memory.
|
void |
traceSkippingJoinOrder(int nextOptimizable,
int joinPosition,
int[] proposedJoinOrder,
JBitSet assignedTableMap) |
Say that we're skipping the join order starting with the next optimizable.
|
void |
traceSkipUnmaterializableHashJoin() |
Say that we won't consider a hash join because the result can't be materialized
|
void |
traceSortCost(CostEstimate sortCost,
CostEstimate currentCost) |
Report the sort cost.
|
void |
traceSortNeededForOrdering(int planType,
RequiredRowOrdering requiredRowOrdering) |
Report that this plan needs a sort
|
void |
traceStartQueryBlock(long timeOptimizationStarted,
int optimizerID,
OptimizableList optimizableList) |
Start optimizer tracing for a query block.
|
void |
traceStartStatement(java.lang.String statementText) |
Start the start of tracing a statement.
|
void |
traceTimeout(long currentTime,
CostEstimate bestCost) |
Say that the optimizer ran out of time.
|
void |
traceUserJoinOrderOptimized() |
Say that we have optimized the user-specified join order.
|
void |
traceVacuous() |
Say that there's nothing to optimizer.
|
public void traceStartStatement(java.lang.String statementText)
OptTracetraceStartStatement in interface OptTracepublic void traceStartQueryBlock(long timeOptimizationStarted,
int optimizerID,
OptimizableList optimizableList)
OptTracetraceStartQueryBlock in interface OptTracepublic void traceEndQueryBlock()
OptTracetraceEndQueryBlock in interface OptTracepublic void traceTimeout(long currentTime,
CostEstimate bestCost)
OptTracetraceTimeout in interface OptTracepublic void traceVacuous()
OptTracetraceVacuous in interface OptTracepublic void traceCompleteJoinOrder()
OptTracetraceCompleteJoinOrder in interface OptTracepublic void traceSortCost(CostEstimate sortCost, CostEstimate currentCost)
OptTracetraceSortCost in interface OptTracepublic void traceNoBestPlan()
OptTracetraceNoBestPlan in interface OptTracepublic void traceModifyingAccessPaths(int optimizerID)
OptTracetraceModifyingAccessPaths in interface OptTracepublic void traceShortCircuiting(boolean timeExceeded,
Optimizable thisOpt,
int joinPosition)
OptTracetraceShortCircuiting in interface OptTracepublic void traceSkippingJoinOrder(int nextOptimizable,
int joinPosition,
int[] proposedJoinOrder,
JBitSet assignedTableMap)
OptTracetraceSkippingJoinOrder in interface OptTracepublic void traceIllegalUserJoinOrder()
OptTracetraceIllegalUserJoinOrder in interface OptTracepublic void traceUserJoinOrderOptimized()
OptTracetraceUserJoinOrderOptimized in interface OptTracepublic void traceJoinOrderConsideration(int joinPosition,
int[] proposedJoinOrder,
JBitSet assignedTableMap)
OptTracetraceJoinOrderConsideration in interface OptTracepublic void traceCostWithoutSortAvoidance(CostEstimate currentCost)
OptTracetraceCostWithoutSortAvoidance in interface OptTracepublic void traceCostWithSortAvoidance(CostEstimate currentSortAvoidanceCost)
OptTracetraceCostWithSortAvoidance in interface OptTracepublic void traceCurrentPlanAvoidsSort(CostEstimate bestCost, CostEstimate currentSortAvoidanceCost)
OptTracetraceCurrentPlanAvoidsSort in interface OptTracepublic void traceCheapestPlanSoFar(int planType,
CostEstimate currentCost)
OptTracetraceCheapestPlanSoFar in interface OptTracepublic void traceSortNeededForOrdering(int planType,
RequiredRowOrdering requiredRowOrdering)
OptTracetraceSortNeededForOrdering in interface OptTracepublic void traceRememberingBestJoinOrder(int joinPosition,
int[] bestJoinOrder,
int planType,
CostEstimate planCost,
JBitSet assignedTableMap)
OptTracetraceRememberingBestJoinOrder in interface OptTracepublic void traceSkippingBecauseTooMuchMemory(int maxMemoryPerTable)
OptTracetraceSkippingBecauseTooMuchMemory in interface OptTracepublic void traceCostOfNScans(int tableNumber,
double rowCount,
CostEstimate cost)
OptTracetraceCostOfNScans in interface OptTracepublic void traceSkipUnmaterializableHashJoin()
OptTracetraceSkipUnmaterializableHashJoin in interface OptTracepublic void traceSkipHashJoinNoHashKeys()
OptTracetraceSkipHashJoinNoHashKeys in interface OptTracepublic void traceHashKeyColumns(int[] hashKeyColumns)
OptTracetraceHashKeyColumns in interface OptTracepublic void traceOptimizingJoinNode()
OptTracetraceOptimizingJoinNode in interface OptTracepublic void traceConsideringJoinStrategy(JoinStrategy js, int tableNumber)
OptTracetraceConsideringJoinStrategy in interface OptTracepublic void traceRememberingBestAccessPath(AccessPath accessPath, int tableNumber, int planType)
OptTracetraceRememberingBestAccessPath in interface OptTracepublic void traceNoMoreConglomerates(int tableNumber)
OptTracetraceNoMoreConglomerates in interface OptTracepublic void traceConsideringConglomerate(ConglomerateDescriptor cd, int tableNumber)
OptTracetraceConsideringConglomerate in interface OptTracepublic void traceScanningHeapWithUniqueKey()
OptTracetraceScanningHeapWithUniqueKey in interface OptTracepublic void traceAddingUnorderedOptimizable(int predicateCount)
OptTracetraceAddingUnorderedOptimizable in interface OptTracepublic void traceChangingAccessPathForTable(int tableNumber)
OptTracetraceChangingAccessPathForTable in interface OptTracepublic void traceNoStartStopPosition()
OptTracetraceNoStartStopPosition in interface OptTracepublic void traceNonCoveringIndexCost(double cost,
int tableNumber)
OptTracetraceNonCoveringIndexCost in interface OptTracepublic void traceConstantStartStopPositions()
OptTracetraceConstantStartStopPositions in interface OptTracepublic void traceEstimatingCostOfConglomerate(ConglomerateDescriptor cd, int tableNumber)
OptTracetraceEstimatingCostOfConglomerate in interface OptTracepublic void traceLookingForSpecifiedIndex(java.lang.String indexName,
int tableNumber)
OptTracetraceLookingForSpecifiedIndex in interface OptTracepublic void traceSingleMatchedRowCost(double cost,
int tableNumber)
OptTracetraceSingleMatchedRowCost in interface OptTracepublic void traceCostIncludingExtra1stColumnSelectivity(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingExtra1stColumnSelectivity in interface OptTracepublic void traceNextAccessPath(java.lang.String baseTable,
int predicateCount)
OptTracetraceNextAccessPath in interface OptTracepublic void traceCostIncludingExtraStartStop(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingExtraStartStop in interface OptTracepublic void traceCostIncludingExtraQualifierSelectivity(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingExtraQualifierSelectivity in interface OptTracepublic void traceCostIncludingExtraNonQualifierSelectivity(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingExtraNonQualifierSelectivity in interface OptTracepublic void traceCostOfNoncoveringIndex(CostEstimate cost, int tableNumber)
OptTracetraceCostOfNoncoveringIndex in interface OptTracepublic void traceRememberingJoinStrategy(JoinStrategy joinStrategy, int tableNumber)
OptTracetraceRememberingJoinStrategy in interface OptTracepublic void traceRememberingBestAccessPathSubstring(AccessPath ap, int tableNumber)
OptTracetraceRememberingBestAccessPathSubstring in interface OptTracepublic void traceRememberingBestSortAvoidanceAccessPathSubstring(AccessPath ap, int tableNumber)
OptTracetraceRememberingBestSortAvoidanceAccessPathSubstring in interface OptTracepublic void traceRememberingBestUnknownAccessPathSubstring(AccessPath ap, int tableNumber)
OptTracetraceRememberingBestUnknownAccessPathSubstring in interface OptTracepublic void traceCostOfConglomerateScan(int tableNumber,
ConglomerateDescriptor cd,
CostEstimate costEstimate,
int numExtraFirstColumnPreds,
double extraFirstColumnSelectivity,
int numExtraStartStopPreds,
double extraStartStopSelectivity,
int startStopPredCount,
double statStartStopSelectivity,
int numExtraQualifiers,
double extraQualifierSelectivity,
int numExtraNonQualifiers,
double extraNonQualifierSelectivity)
OptTracetraceCostOfConglomerateScan in interface OptTracepublic void traceCostIncludingCompositeSelectivityFromStats(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingCompositeSelectivityFromStats in interface OptTracepublic void traceCompositeSelectivityFromStatistics(double statCompositeSelectivity)
OptTracetraceCompositeSelectivityFromStatistics in interface OptTracepublic void traceCostIncludingStatsForIndex(CostEstimate cost, int tableNumber)
OptTracetraceCostIncludingStatsForIndex in interface OptTracepublic void printToWriter(java.io.PrintWriter out)
OptTraceprintToWriter in interface OptTraceprivate java.lang.String reportJoinOrder(java.lang.String prefix,
boolean addJoinOrderNumber,
int joinOrderNumber,
int joinPosition,
int[] joinOrder,
JBitSet assignedTableMap)
private java.lang.String reportConglomerateDescriptor(ConglomerateDescriptor cd)
private java.lang.String reportCostForTable(java.lang.Object cost,
int tableNumber)
private java.lang.String reportCostIncluding(java.lang.String selectivityType,
CostEstimate cost,
int tableNumber)
private void appendTraceString(java.lang.String traceString)
Apache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.