Skip to content

RuntimeReplaceable Expressions

RuntimeReplaceable is the marker contract for unary expressions that are replaced by Logical Optimizer with their child expression (that can then be evaluated).


Catalyst Optimizer uses ReplaceExpressions logical optimization to replace RuntimeReplaceable expressions.

RuntimeReplaceable contract allows for expression aliases, i.e. expressions that are fairly complex in the inside than on the outside, and is used to provide compatibility with other SQL databases by supporting SQL functions with their more complex Catalyst expressions (that are already supported by Spark SQL).


RuntimeReplaceables are tied up to their SQL functions in FunctionRegistry.


To make sure the explain plan and expression SQL works correctly, a RuntimeReplaceable implementation should override flatArguments and sql methods.