Package org.apache.druid.math.expr

Class Function.MultiValueStringHarmonizeNullsFunction

java.lang.Object

org.apache.druid.math.expr.Function.MultiValueStringHarmonizeNullsFunction

All Implemented Interfaces:

Function, NamedFunction

Enclosing interface:

Function

public static class Function.MultiValueStringHarmonizeNullsFunction
extends Object
implements Function

Primarily internal helper function used to coerce null, [], and [null] into [null], similar to the logic done by ExpressionSelectors.supplierFromDimensionSelector(org.apache.druid.segment.DimensionSelector, boolean, boolean) when the 3rd argument is true, which is done when implicitly mapping scalar functions over mvd values. Was formerly generated by the SQL layer for MV_CONTAINS and MV_OVERLAP, but is no longer generated, since the SQL layer now prefers using Function.MvContainsFunction and Function.MvOverlapFunction. This function remains here for backwards compatibility.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.druid.math.expr.Function

Function.Abs, Function.Acos, Function.ArrayAddElementFunction, Function.ArrayAppendFunction, Function.ArrayConcatFunction, Function.ArrayConstructorFunction, Function.ArrayContainsFunction, Function.ArrayLengthFunction, Function.ArrayOffsetFunction, Function.ArrayOffsetOfFunction, Function.ArrayOrdinalFunction, Function.ArrayOrdinalOfFunction, Function.ArrayOverlapFunction, Function.ArrayPrependFunction, Function.ArrayScalarFunction, Function.ArraySetAddAllFunction, Function.ArraySetAddFunction, Function.ArraysFunction, Function.ArraySliceFunction, Function.ArraysMergeFunction, Function.ArrayToMultiValueStringFunction, Function.ArrayToStringFunction, Function.Asin, Function.Atan, Function.Atan2, Function.BitwiseAnd, Function.BitwiseComplement, Function.BitwiseConvertDoubleToLongBits, Function.BitwiseConvertLongBitsToDouble, Function.BitwiseOr, Function.BitwiseShiftLeft, Function.BitwiseShiftRight, Function.BitwiseXor, Function.BivariateBitwiseMathFunction, Function.BivariateFunction, Function.BivariateMathFunction, Function.CaseSearchedFunc, Function.CaseSimpleFunc, Function.CastFunc, Function.Cbrt, Function.Ceil, Function.CoalesceFunc, Function.ConcatFunc, Function.ConditionFunc, Function.CopySign, Function.Cos, Function.Cosh, Function.Cot, Function.Div, Function.DoubleBivariateMathFunction, Function.DoubleUnivariateMathFunction, Function.Exp, Function.Expm1, Function.Floor, Function.GetExponent, Function.GreatestFunc, Function.HumanReadableBinaryByteFormatFunc, Function.HumanReadableDecimalByteFormatFunc, Function.HumanReadableDecimalFormatFunc, Function.Hypot, Function.IsDistinctFromFunc, Function.IsFalseFunc, Function.IsNotDistinctFromFunc, Function.IsNotFalseFunc, Function.IsNotNullFunc, Function.IsNotTrueFunc, Function.IsNullFunc, Function.IsTrueFunc, Function.LeastFunc, Function.LeftFunc, Function.Log, Function.Log10, Function.Log1p, Function.LowerFunc, Function.LpadFunc, Function.Max, Function.Min, Function.MultiValueStringHarmonizeNullsFunction, Function.MultiValueStringToArrayFunction, Function.MvContainsFunction, Function.MvOverlapFunction, Function.NextAfter, Function.NextUp, Function.NvlFunc, Function.ParseLong, Function.Pi, Function.Pow, Function.ReduceFunction, Function.Remainder, Function.RepeatFunc, Function.ReplaceFunc, Function.ReverseFunc, Function.RightFunc, Function.Rint, Function.Round, Function.RpadFunc, Function.SafeDivide, Function.ScalarInArrayFunction, Function.Scalb, Function.Signum, Function.Sin, Function.Sinh, Function.SizeFormatFunc, Function.Sqrt, Function.StringFormatFunc, Function.StringLongFunction, Function.StringToArrayFunction, Function.StrlenFunc, Function.StrposFunc, Function.SubMonthFunc, Function.SubstringFunc, Function.Tan, Function.Tanh, Function.TimestampFromEpochFunc, Function.ToDegrees, Function.ToRadians, Function.Ulp, Function.UnivariateFunction, Function.UnivariateMathFunction, Function.UnixTimestampFunc, Function.UpperFunc

Constructor Summary

Constructors

Constructor	Description
MultiValueStringHarmonizeNullsFunction()

Method Summary

Modifier and Type	Method	Description
ExprEval	apply(List<Expr> args, Expr.ObjectBinding bindings)	Evaluate the function, given a list of arguments and a set of bindings to provide values for IdentifierExpr.
Set<Expr>	getArrayInputs(List<Expr> args)	Given a list of arguments to this Function, get the set of arguments that must evaluate to an array value
ExpressionType	getOutputType(Expr.InputBindingInspector inspector, List<Expr> args)	Compute the output type of this function for a given set of argument expression inputs.
Set<Expr>	getScalarInputs(List<Expr> args)	Given a list of arguments to this Function, get the set of arguments that must evaluate to a scalar value
boolean	hasArrayInputs()	Returns true if a function expects any array arguments
boolean	hasArrayOutput()	Returns true if function produces an array.
String	name()	Name of the function
void	validateArguments(List<Expr> args)	Validate function arguments.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.druid.math.expr.Function

asBitmapColumnIndex, asColumnIndexSupplier, asSingleThreaded, asVectorProcessor, canVectorize

Methods inherited from interface org.apache.druid.math.expr.NamedFunction

processingFailed, processingFailed, validationFailed, validationFailed, validationHelperCheckAnyOfArgumentCount, validationHelperCheckArgIsLiteral, validationHelperCheckArgumentCount, validationHelperCheckArgumentCount, validationHelperCheckArgumentRange, validationHelperCheckLambaArgumentCount, validationHelperCheckMinArgumentCount, validationHelperCheckMinArgumentCount

Constructor Details

MultiValueStringHarmonizeNullsFunction

public MultiValueStringHarmonizeNullsFunction()

Method Details

name

public String name()

Description copied from interface: NamedFunction

Name of the function

Specified by:

name in interface NamedFunction

apply

public ExprEval apply(List<Expr> args,
 Expr.ObjectBinding bindings)

Description copied from interface: Function

Evaluate the function, given a list of arguments and a set of bindings to provide values for IdentifierExpr.

Specified by:

apply in interface Function

validateArguments

public void validateArguments(List<Expr> args)

Description copied from interface: Function

Validate function arguments. This method is called whenever a FunctionExpr is created, and should validate everything that is feasible up front. Note that input type information is typically unavailable at the time Expr are parsed, and so this method is incapable of performing complete validation.

Specified by:

validateArguments in interface Function

getOutputType

@Nullable
public ExpressionType getOutputType(Expr.InputBindingInspector inspector,
 List<Expr> args)

Description copied from interface: Function

Compute the output type of this function for a given set of argument expression inputs.

Specified by:

getOutputType in interface Function

See Also:

• Expr.getOutputType(org.apache.druid.math.expr.Expr.InputBindingInspector)

hasArrayInputs

public boolean hasArrayInputs()

Description copied from interface: Function

Returns true if a function expects any array arguments

Specified by:

hasArrayInputs in interface Function

hasArrayOutput

public boolean hasArrayOutput()

Description copied from interface: Function

Returns true if function produces an array. All Function implementations are expected to exclusively produce either scalar or array values.

Specified by:

hasArrayOutput in interface Function

getScalarInputs

public Set<Expr> getScalarInputs(List<Expr> args)

Description copied from interface: Function

Given a list of arguments to this Function, get the set of arguments that must evaluate to a scalar value

Specified by:

getScalarInputs in interface Function

getArrayInputs

public Set<Expr> getArrayInputs(List<Expr> args)

Description copied from interface: Function

Given a list of arguments to this Function, get the set of arguments that must evaluate to an array value

Specified by:

getArrayInputs in interface Function