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

Class PromqlCommand

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.PromqlCommand
All Implemented Interfaces:
NamedWriteable, Writeable, PostAnalysisVerificationAware, TelemetryAware, Resolvable, TimestampAware
public class PromqlCommand extends UnaryPlan implements TelemetryAware, PostAnalysisVerificationAware, TimestampAware
Container plan for embedded PromQL queries. Gets eliminated by the analyzer once the query is validated.

  • Constructor Details

  • Method Details

    • info

      protected NodeInfo<PromqlCommand> info()
      Specified by:
      info in class Node<LogicalPlan>

    • replaceChild

      public PromqlCommand replaceChild(LogicalPlan newChild)
      Specified by:
      replaceChild in class UnaryPlan

    • withPromqlPlan

      public PromqlCommand withPromqlPlan(LogicalPlan newPromqlPlan)

    • expressionsResolved

      public boolean expressionsResolved()
      Specified by:
      expressionsResolved in class LogicalPlan

    • telemetryLabel

      public String telemetryLabel()
      Specified by:
      telemetryLabel in interface TelemetryAware
      Returns:
      the label reported in the telemetry data. Only needs to be overwritten if the label doesn't match the class name.

    • getWriteableName

      public String getWriteableName()
      Specified by:
      getWriteableName in interface NamedWriteable

    • writeTo

      public void writeTo(StreamOutput out) throws IOException
      Specified by:
      writeTo in interface Writeable
      Throws:
      IOException

    • promqlPlan

      public LogicalPlan promqlPlan()

    • start

      public Literal start()

    • end

      public Literal end()

    • step

      public Literal step()

    • isInstantQuery

      public boolean isInstantQuery()

    • isRangeQuery

      public boolean isRangeQuery()

    • valueColumnName

      public String valueColumnName()

    • valueId

      public NameId valueId()

    • stepId

      public NameId stepId()

    • timestamp

      public Expression timestamp()
      Specified by:
      timestamp in interface TimestampAware

    • output

      public List<Attribute> output()
      Description copied from class: QueryPlan
      The ordered list of attributes (i.e. columns) this plan produces when executed. Must be called only on resolved plans, otherwise may throw an exception or return wrong results.
      Overrides:
      output in class UnaryPlan

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class UnaryPlan

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class UnaryPlan

    • nodeString

      public String nodeString()
      Overrides:
      nodeString in class Node<LogicalPlan>

    • postAnalysisVerification

      public void postAnalysisVerification(Failures failures)
      Description copied from interface: PostAnalysisVerificationAware
      Allows the implementer to validate itself. This usually involves checking its internal setup, which often means checking the parameters it received on construction: their data or syntactic type, class, their count, expressions' structure etc. The discovered failures are added to the given Failures object.

      It is often more useful to perform the checks as extended as it makes sense, over stopping at the first failure. This will allow the author to progress faster to a correct query.

      Example: the Filter class, which models the WHERE command, checks that the expression it filters on - condition - is of a Boolean or NULL type: 

           
     @Override
     void postAnalysisVerification(Failures failures) {
          if (condition.dataType() != NULL && condition.dataType() != BOOLEAN) {
              failures.add(fail(condition, "Condition expression needs to be boolean, found [{}]", condition.dataType()));
          }
     }
      Specified by:
      postAnalysisVerification in interface PostAnalysisVerificationAware
      Parameters:
      failures - the object to add failures to.