Skip to content

Common Fields

Every relation contains a common section containing optional hints and emit behavior.

Emit

A relation which has a direct emit kind outputs the relation’s output without reordering or selection. A relation that specifies an emit output mapping can output its output columns in any order and may leave output columns out.

Relation Output
  • Many relations (such as Project) by default provide as their output the list of all their input columns plus any generated columns as its output columns. Review each relation to understand its specific output default.

Hints

Hints provide information that can improve performance but cannot be used to control the behavior. Table statistics, runtime constraints, name hints, and saved computations all fall into this category.

Hint Design
  • If a hint is not present or has incorrect data the consumer should be able to ignore it and still arrive at the correct result.

Saved Computations

Computations can be used to save a data structure to use elsewhere. For instance, let’s say we have a plan with a HashEquiJoin and an AggregateDistinct operation. The HashEquiJoin could save its hash table as part of saved computation id number 1 and the AggregateDistinct could read in computation id number 1.