Package org.elasticsearch.xpack.esql.plan.logical.promql.selector

Class LiteralSelector

java.lang.Object

org.elasticsearch.xpack.esql.core.tree.Node<LogicalPlan>

org.elasticsearch.xpack.esql.plan.QueryPlan<LogicalPlan>

org.elasticsearch.xpack.esql.plan.logical.LogicalPlan

org.elasticsearch.xpack.esql.plan.logical.UnaryPlan

org.elasticsearch.xpack.esql.plan.logical.promql.selector.Selector

org.elasticsearch.xpack.esql.plan.logical.promql.selector.LiteralSelector

All Implemented Interfaces:

NamedWriteable, Writeable, Resolvable, PromqlPlan

public final class LiteralSelector
extends Selector

Represents a PromQL literal scalar value wrapped as a vector selector. In PromQL, literal numeric values can be used as instant vectors where each sample in the result has the same scalar value with no labels. This corresponds to PromQL syntax like: 42 3.14 -5.5 Examples: http_requests_total + 10 // Add 10 to each sample cpu_usage * 100 // Multiply by 100 rate(requests[5m]) > 0.5 // Compare against threshold The literal selector produces a single-value vector with no labels, allowing literals to participate in vector operations and binary expressions.

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.xpack.esql.plan.logical.LogicalPlan

LogicalPlan.Stage

Nested classes/interfaces inherited from class org.elasticsearch.xpack.esql.core.tree.Node

Node.NodeStringFormat

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields inherited from class org.elasticsearch.xpack.esql.plan.logical.promql.selector.Selector

output

Fields inherited from class org.elasticsearch.xpack.esql.core.tree.Node

TO_STRING_MAX_LINES, TO_STRING_MAX_WIDTH

Constructor Summary

Constructors

Constructor	Description
LiteralSelector(Source source, Literal literal)
LiteralSelector(Source source, LogicalPlan child, Literal literal)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
int	hashCode()
protected NodeInfo<LiteralSelector>	info()	Normally, you want to use one of the static create methods to implement this.
Literal	literal()
LiteralSelector	replaceChild(LogicalPlan newChild)
PromqlDataType	returnType()	The PromQL return type of this plan node.
String	telemetryLabel()

Methods inherited from class org.elasticsearch.xpack.esql.plan.logical.promql.selector.Selector

evaluation, expressionsResolved, getWriteableName, labelMatchers, labels, series, writeTo

Methods inherited from class org.elasticsearch.xpack.esql.plan.logical.UnaryPlan

child, inputSet, output, outputSet, replaceChildren

Methods inherited from class org.elasticsearch.xpack.esql.plan.logical.LogicalPlan

analyzed, childrenResolved, optimized, preAnalyzed, preOptimized, resolved, setAnalyzed, setOptimized, setPreAnalyzed, setPreOptimized

Methods inherited from class org.elasticsearch.xpack.esql.plan.QueryPlan

computeExpressions, computeReferences, expressions, forEachExpression, forEachExpression, forEachExpressionDown, forEachExpressionUp, references, transformExpressionsDown, transformExpressionsDown, transformExpressionsOnly, transformExpressionsOnly, transformExpressionsOnlyUp, transformExpressionsUp, transformExpressionsUp

Methods inherited from class org.elasticsearch.xpack.esql.core.tree.Node

allMatch, anyMatch, children, collect, collect, collect, collectFirstChildren, collectLeaves, doCollectFirst, forEachDown, forEachDown, forEachDownMayReturnEarly, forEachProperty, forEachPropertyDown, forEachPropertyOnly, forEachPropertyUp, forEachUp, forEachUp, nodeName, nodeProperties, nodeString, nodeString, propertiesToString, replaceChildrenSameSize, source, sourceLocation, sourceText, toString, toString, transformChildren, transformChildren, transformDown, transformDown, transformDown, transformDown, transformDownSkipBranch, transformNodeProps, transformPropertiesDown, transformPropertiesOnly, transformPropertiesUp, transformUp, transformUp, transformUp

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.xpack.esql.plan.logical.promql.PromqlPlan

output

Constructor Details

LiteralSelector

public LiteralSelector(Source source,
 Literal literal)

LiteralSelector

public LiteralSelector(Source source,
 LogicalPlan child,
 Literal literal)

Method Details

literal

public Literal literal()

info

protected NodeInfo<LiteralSelector> info()

Description copied from class: Node

Normally, you want to use one of the static create methods to implement this.

For QueryPlans, it is very important that the properties contain all of the expressions and references relevant to this node, and that all the properties are used in the provided constructor; otherwise query plan transformations like QueryPlan#transformExpressionsOnly(Function) will not have an effect.

Specified by:

info in class Node<LogicalPlan>

replaceChild

public LiteralSelector replaceChild(LogicalPlan newChild)

Specified by:

replaceChild in class UnaryPlan

telemetryLabel

public String telemetryLabel()

equals

public boolean equals(Object o)

Overrides:

equals in class Selector

hashCode

public int hashCode()

Overrides:

hashCode in class Selector

returnType

public PromqlDataType returnType()

Description copied from interface: PromqlPlan

The PromQL return type of this plan node.