Class QueryProfiler

java.lang.Object

com.loomcache.server.query.QueryProfiler

public class QueryProfiler
extends Object

Profiles query execution stages to identify bottlenecks. Tracks timing and row processing for each stage of query execution.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	QueryProfiler.ProfileEntry	Record representing a single profiling entry for a stage.
static final record	QueryProfiler.QueryProfile	Complete query profile with stage information and bottleneck identification.
static enum	QueryProfiler.Stage	Query execution stages.

Constructor Summary

Constructors

Constructor	Description
QueryProfiler(String sql)	Creates a new QueryProfiler for profiling a specific SQL query.

Method Summary

Modifier and Type	Method	Description
void	beginStage(QueryProfiler.Stage stage)	Begins profiling a stage.
void	endStage(QueryProfiler.Stage stage, long rowsProcessed)	Ends profiling a stage and records timing and row count.
QueryProfiler.QueryProfile	getProfile()	Returns the complete query profile with bottleneck analysis.
long	getStageDurationMs(QueryProfiler.Stage stage)	Returns timing for a specific stage in milliseconds.
long	getStageDurationNs(QueryProfiler.Stage stage)	Returns timing for a specific stage in nanoseconds.
long	getStageRowCount(QueryProfiler.Stage stage)	Returns row count for a specific stage.

Methods inherited from class Object

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

Constructor Details

QueryProfiler

public QueryProfiler(String sql)

Creates a new QueryProfiler for profiling a specific SQL query.

Parameters:

sql - the SQL query being profiled

Method Details

beginStage

public void beginStage(QueryProfiler.Stage stage)

Begins profiling a stage.

Parameters:

stage - the query stage to profile

endStage

public void endStage(QueryProfiler.Stage stage,
 long rowsProcessed)

Ends profiling a stage and records timing and row count.

Parameters:

stage - the query stage being completed

rowsProcessed - number of rows processed in this stage

getProfile

public QueryProfiler.QueryProfile getProfile()

Returns the complete query profile with bottleneck analysis.

Returns:

QueryProfile with all stage information

getStageDurationNs

public long getStageDurationNs(QueryProfiler.Stage stage)

Returns timing for a specific stage in nanoseconds.

Parameters:

stage - the stage to query

Returns:

duration in nanoseconds, or 0 if not profiled

getStageRowCount

public long getStageRowCount(QueryProfiler.Stage stage)

Returns row count for a specific stage.

Parameters:

stage - the stage to query

Returns:

row count, or 0 if not profiled

getStageDurationMs

public long getStageDurationMs(QueryProfiler.Stage stage)

Returns timing for a specific stage in milliseconds.

Parameters:

stage - the stage to query

Returns:

duration in milliseconds, or 0 if not profiled