@Internal public final class BuiltInFunctionDefinition extends Object implements SpecializedFunction
Compared to regular FunctionDefinition, built-in functions have a default name. This
default name is used to lookup the function in a catalog during resolution.
Equality is defined by reference equality.
| 限定符和类型 | 类和说明 |
|---|---|
static class |
BuiltInFunctionDefinition.Builder
Builder for fluent definition of built-in functions.
|
SpecializedFunction.SpecializedContext| 限定符和类型 | 方法和说明 |
|---|---|
FunctionKind |
getKind()
Returns the kind of function this definition describes.
|
String |
getName() |
Optional<String> |
getRuntimeClass() |
TypeInference |
getTypeInference(DataTypeFactory typeFactory)
Returns the logic for performing type inference of a call to this function definition.
|
boolean |
hasRuntimeImplementation() |
boolean |
isDeterministic()
Returns information about the determinism of the function's results.
|
static BuiltInFunctionDefinition.Builder |
newBuilder()
Builder for configuring and creating instances of
BuiltInFunctionDefinition. |
UserDefinedFunction |
specialize(SpecializedFunction.SpecializedContext context)
Provides a runtime implementation that is specialized for the given call and session.
|
String |
toString() |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitgetRequirementspublic static BuiltInFunctionDefinition.Builder newBuilder()
BuiltInFunctionDefinition.public String getName()
public boolean hasRuntimeImplementation()
public UserDefinedFunction specialize(SpecializedFunction.SpecializedContext context)
SpecializedFunctionThe method must return an instance of UserDefinedFunction or throw a TableException if the given call is not supported. The returned instance must have the same
FunctionDefinition semantics but can have a different FunctionDefinition.getTypeInference(DataTypeFactory) implementation.
specialize 在接口中 SpecializedFunctionpublic FunctionKind getKind()
FunctionDefinitiongetKind 在接口中 FunctionDefinitionpublic TypeInference getTypeInference(DataTypeFactory typeFactory)
FunctionDefinitionThe type inference process is responsible for inferring unknown types of input arguments, validating input arguments, and producing result types. The type inference process happens independent of a function body. The output of the type inference is used to search for a corresponding runtime implementation.
Instances of type inference can be created by using TypeInference.newBuilder().
See BuiltInFunctionDefinitions for concrete usage examples.
getTypeInference 在接口中 FunctionDefinitionpublic boolean isDeterministic()
FunctionDefinitionIt returns true if and only if a call to this function is guaranteed to
always return the same result given the same parameters. true is assumed by
default. If the function is not purely functional like random(), date(), now(), ...
this method must return false.
Furthermore, return false if the planner should always execute this function
on the cluster side. In other words: the planner should not perform constant expression
reduction during planning for constant calls to this function.
isDeterministic 在接口中 FunctionDefinitionCopyright © 2014–2022 The Apache Software Foundation. All rights reserved.