Package org.elasticsearch.xpack.esql.view

Class ViewResolver

java.lang.Object

org.elasticsearch.xpack.esql.view.ViewResolver

public class ViewResolver
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ViewResolver.ViewResolutionResult	Result of view resolution containing both the rewritten plan and the view queries.

Field Summary

Fields

Modifier and Type	Field	Description
protected org.elasticsearch.logging.Logger	log
static final Setting<Integer>	MAX_VIEW_DEPTH_SETTING

Constructor Summary

Constructors

Constructor	Description
ViewResolver()	Public constructor for NOOP instance (in release mode, when component is not registered, but TransportEsqlQueryAction still needs it)
ViewResolver(ClusterService clusterService, ProjectResolver projectResolver, Client client, CrossProjectModeDecider crossProjectModeDecider)

Method Summary

Modifier and Type	Method	Description
protected void	doEsqlResolveViewsRequest(EsqlResolveViewAction.Request request, ActionListener<EsqlResolveViewAction.Response> listener)
void	replaceViews(LogicalPlan plan, BiFunction<String,String,LogicalPlan> parser, ActionListener<ViewResolver.ViewResolutionResult> listener)	Replaces views in the logical plan with their subqueries recursively.
protected boolean	viewsFeatureEnabled()

Methods inherited from class java.lang.Object

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

Field Details

log

protected org.elasticsearch.logging.Logger log

MAX_VIEW_DEPTH_SETTING

public static final Setting<Integer> MAX_VIEW_DEPTH_SETTING

Constructor Details

ViewResolver

public ViewResolver()

Public constructor for NOOP instance (in release mode, when component is not registered, but TransportEsqlQueryAction still needs it)

ViewResolver

public ViewResolver(ClusterService clusterService,
 ProjectResolver projectResolver,
 Client client,
 CrossProjectModeDecider crossProjectModeDecider)

Method Details

viewsFeatureEnabled

protected boolean viewsFeatureEnabled()

replaceViews

public void replaceViews(LogicalPlan plan,
 BiFunction<String,String,LogicalPlan> parser,
 ActionListener<ViewResolver.ViewResolutionResult> listener)

Replaces views in the logical plan with their subqueries recursively.

This method performs a depth-first, top-down (pre-order) traversal of the plan tree. During traversal, it intercepts specific node types:

• UnresolvedRelation: Resolves views and replaces them with their query plans, then recursively processes those plans
• Fork: Recursively processes each child branch
• UnionAll: Skipped (assumes rewriting is already complete)

View resolution may introduce new nodes that need further processing, so explicit recursive calls are made on newly resolved view plans. The method tracks circular references and enforces maximum view depth limits.

Parameters:

plan - the logical plan to process

parser - function to parse view query strings into logical plans

listener - callback that receives the rewritten plan and a map of view names to their queries

doEsqlResolveViewsRequest

protected void doEsqlResolveViewsRequest(EsqlResolveViewAction.Request request,
 ActionListener<EsqlResolveViewAction.Response> listener)