Package org.apache.calcite.sql

Class SqlBinaryOperator

java.lang.Object

org.apache.calcite.sql.SqlOperator

org.apache.calcite.sql.SqlBinaryOperator

Direct Known Subclasses:

SqlFilterOperator, SqlInOperator, SqlMonotonicBinaryOperator, SqlMultisetMemberOfOperator, SqlMultisetSetOperator, SqlOverlapsOperator, SqlOverOperator, SqlPosixRegexOperator, SqlSetOperator, SqlWithinDistinctOperator, SqlWithinGroupOperator

public class SqlBinaryOperator
extends SqlOperator

SqlBinaryOperator is a binary operator.

Field Summary

Fields inherited from class org.apache.calcite.sql.SqlOperator

kind, MDX_PRECEDENCE, NL

Constructor Summary

Constructors

Constructor	Description
SqlBinaryOperator(String name, SqlKind kind, int prec, boolean leftAssoc, @Nullable SqlReturnTypeInference returnTypeInference, @Nullable SqlOperandTypeInference operandTypeInference, @Nullable SqlOperandTypeChecker operandTypeChecker)	Creates a SqlBinaryOperator.

Method Summary

Modifier and Type	Method	Description
protected RelDataType	adjustType(SqlValidator validator, SqlCall call, RelDataType type)	Validates and determines coercibility and resulting collation name of binary operator if needed.
RelDataType	deriveType(SqlValidator validator, SqlValidatorScope scope, SqlCall call)	Derives the type of a call to this operator.
SqlMonotonicity	getMonotonicity(SqlOperatorBinding call)	Returns whether a call to this operator is monotonic.
@Nullable String	getSignatureTemplate(int operandsCount)	Returns a template describing how the operator signature is to be built.
SqlSyntax	getSyntax()	Returns the syntactic type of this operator, never null.
@Nullable SqlOperator	reverse()	Returns the operator that has the same effect as this operator if its arguments are reversed.
boolean	validRexOperands(int count, Litmus litmus)	Returns whether the given operands are valid.

Methods inherited from class org.apache.calcite.sql.SqlOperator

acceptCall, acceptCall, allowsFraming, argumentMustBeScalar, checkOperandCount, checkOperandTypes, constructArgNameList, constructArgTypeList, constructOperandList, createCall, createCall, createCall, createCall, createCall, createCall, createCall, deriveOperandType, equals, getAllowedSignatures, getAllowedSignatures, getKind, getLeftPrec, getMonotonicity, getName, getNameAsId, getOperandCountRange, getOperandTypeChecker, getOperandTypeInference, getReturnTypeInference, getRightPrec, getSqlCallFactory, getStrongPolicyInference, hashCode, inferReturnType, inferReturnType, isAggregator, isDeterministic, isDynamicFunction, isGroup, isGroupAuxiliary, isName, isSymmetrical, leftPrec, not, preValidateCall, requiresDecimalExpansion, requiresOrder, requiresOver, rewriteCall, rightPrec, toString, unparse, unparseListClause, unparseListClause, validateCall, validateOperands

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

SqlBinaryOperator

public SqlBinaryOperator(String name,
 SqlKind kind,
 int prec,
 boolean leftAssoc,
 @Nullable SqlReturnTypeInference returnTypeInference,
 @Nullable SqlOperandTypeInference operandTypeInference,
 @Nullable SqlOperandTypeChecker operandTypeChecker)

Creates a SqlBinaryOperator.

Parameters:

name - Name of operator

kind - Kind

prec - Precedence

leftAssoc - Left-associativity

returnTypeInference - Strategy to infer return type

operandTypeInference - Strategy to infer operand types

operandTypeChecker - Validator for operand types

Method Details

getSyntax

public SqlSyntax getSyntax()

Description copied from class: SqlOperator

Returns the syntactic type of this operator, never null.

Specified by:

getSyntax in class SqlOperator

getSignatureTemplate

public @Nullable String getSignatureTemplate(int operandsCount)

Description copied from class: SqlOperator

Returns a template describing how the operator signature is to be built. E.g for the binary + operator the template looks like "{1} {0} {2}" {0} is the operator, subsequent numbers are operands.

Overrides:

getSignatureTemplate in class SqlOperator

Parameters:

operandsCount - is used with functions that can take a variable number of operands

Returns:

signature template, or null to indicate that a default template will suffice

reverse

public @Nullable SqlOperator reverse()

Description copied from class: SqlOperator

Returns the operator that has the same effect as this operator if its arguments are reversed.

For example, SqlStdOperatorTable.GREATER_THAN.reverse() returns SqlStdOperatorTable.LESS_THAN, and vice versa, because a > b is equivalent to b < a.

SqlStdOperatorTable.EQUALS.reverse() returns itself.

By default, returns null, which means there is no inverse operator.

Overrides:

reverse in class SqlOperator

See Also:

• SqlOperator.not()
• SqlKind.reverse()

adjustType

protected RelDataType adjustType(SqlValidator validator,
 SqlCall call,
 RelDataType type)

Description copied from class: SqlOperator

Validates and determines coercibility and resulting collation name of binary operator if needed.

Overrides:

adjustType in class SqlOperator

deriveType

public RelDataType deriveType(SqlValidator validator,
 SqlValidatorScope scope,
 SqlCall call)

Description copied from class: SqlOperator

Derives the type of a call to this operator.

This method is an intrinsic part of the validation process so, unlike SqlOperator.inferReturnType(org.apache.calcite.sql.SqlOperatorBinding), specific operators would not typically override this method.

Overrides:

deriveType in class SqlOperator

Parameters:

validator - Validator

scope - Scope of validation

call - Call to this operator

Returns:

Type of call

getMonotonicity

public SqlMonotonicity getMonotonicity(SqlOperatorBinding call)

Description copied from class: SqlOperator

Returns whether a call to this operator is monotonic.

Default implementation returns SqlMonotonicity.NOT_MONOTONIC.

Overrides:

getMonotonicity in class SqlOperator

Parameters:

call - Call to this operator with particular arguments and information about the monotonicity of the arguments

validRexOperands

public boolean validRexOperands(int count,
 Litmus litmus)

Description copied from class: SqlOperator

Returns whether the given operands are valid. If not valid and fail, throws an assertion error.

Similar to SqlOperator.checkOperandCount(org.apache.calcite.sql.validate.SqlValidator, org.apache.calcite.sql.type.SqlOperandTypeChecker, org.apache.calcite.sql.SqlCall), but some operators may have different valid operands in SqlNode and RexNode formats (some examples are CAST and AND), and this method throws internal errors, not user errors.

Overrides:

validRexOperands in class SqlOperator