// Copyright 2023 PingCAP, Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace DB { namespace ErrorCodes { extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH; extern const int FUNCTION_IS_SPECIAL; extern const int ARGUMENT_OUT_OF_BOUND; extern const int TOO_SLOW; extern const int ILLEGAL_COLUMN; extern const int ILLEGAL_TYPE_OF_ARGUMENT; extern const int FUNCTION_THROW_IF_VALUE_IS_NON_ZERO; } // namespace ErrorCodes /** Helper functions * * visibleWidth(x) - calculates the approximate width when outputting the value in a text (tab-separated) form to the console. * * toTypeName(x) - get the type name * blockSize() - get the block size * materialize(x) - materialize the constant * ignore(...) is a function that takes any arguments, and always returns 0. * sleep(seconds) - the specified number of seconds sleeps each block. * * in(x, set) - function for evaluating the IN * notIn(x, set) - and NOT IN. * * replicate(x, arr) - creates an array of the same size as arr, all elements of which are equal to x; * for example: replicate(1, ['a', 'b', 'c']) = [1, 1, 1]. * * sleep(n) - sleeps n seconds for each block. * * bar(x, min, max, width) - draws a strip from the number of characters proportional to (x - min) and equal to width for x == max. * * version() - returns the current version of the server on the line. * * finalizeAggregation(agg_state) - get the result from the aggregation state. * * runningAccumulate(agg_state) - takes the states of the aggregate function and returns a column with values, * are the result of the accumulation of these states for a set of block lines, from the first to the current line. */ class FunctionCurrentDatabase : public IFunction { const String db_name; public: static constexpr auto name = "currentDatabase"; static FunctionPtr create(const Context & context) { return std::make_shared(context.getCurrentDatabase()); } explicit FunctionCurrentDatabase(const String & db_name) : db_name{db_name} {} String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } bool isDeterministic() const override { return false; } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, const size_t result) const override { block.getByPosition(result).column = DataTypeString().createColumnConst(block.rows(), db_name); } }; /// Get the host name. Is is constant on single server, but is not constant in distributed queries. class FunctionHostName : public IFunction { public: static constexpr auto name = "hostName"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } /** convertToFullColumn needed because in distributed query processing, * each server returns its own value. */ void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { block.getByPosition(result).column = block.getByPosition(result) .type->createColumnConst(block.rows(), Poco::Net::DNS::hostName()) ->convertToFullColumnIfConst(); } }; class FunctionVisibleWidth : public IFunction { public: static constexpr auto name = "visibleWidth"; static FunctionPtr create(const Context &) { return std::make_shared(); } bool useDefaultImplementationForNulls() const override { return false; } /// Get the name of the function. String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } bool useDefaultImplementationForConstants() const override { return true; } /// Execute the function on the block. void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override; }; /// Returns name of IDataType instance (name of data type). class FunctionToTypeName : public IFunction { public: static constexpr auto name = "toTypeName"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool useDefaultImplementationForNulls() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } /// Execute the function on the block. void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { block.getByPosition(result).column = DataTypeString().createColumnConst(block.rows(), block.getByPosition(arguments[0]).type->getName()); } }; /// Returns number of fields in Enum data type of passed value. class FunctionGetSizeOfEnumType : public IFunction { public: static constexpr auto name = "getSizeOfEnumType"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool useDefaultImplementationForNulls() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { if (checkDataType(arguments[0].get())) return std::make_shared(); else if (checkDataType(arguments[0].get())) return std::make_shared(); throw Exception( "The argument for function " + getName() + " must be Enum", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { if (const auto * type = checkAndGetDataType(block.getByPosition(arguments[0]).type.get())) block.getByPosition(result).column = DataTypeUInt8().createColumnConst(block.rows(), static_cast(type->getValues().size())); else if (const auto * type = checkAndGetDataType(block.getByPosition(arguments[0]).type.get())) block.getByPosition(result).column = DataTypeUInt16().createColumnConst(block.rows(), static_cast(type->getValues().size())); else throw Exception( "The argument for function " + getName() + " must be Enum", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); } }; /// Returns name of IColumn instance. class FunctionToColumnTypeName : public IFunction { public: static constexpr auto name = "toColumnTypeName"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool useDefaultImplementationForNulls() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { block.getByPosition(result).column = DataTypeString().createColumnConst(block.rows(), block.getByPosition(arguments[0]).column->getName()); } }; /// Dump the structure of type and column. class FunctionDumpColumnStructure : public IFunction { public: static constexpr auto name = "dumpColumnStructure"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool useDefaultImplementationForNulls() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const auto & elem = block.getByPosition(arguments[0]); /// Note that the result is not a constant, because it contains block size. block.getByPosition(result).column = DataTypeString() .createColumnConst(block.rows(), elem.type->getName() + ", " + elem.column->dumpStructure()) ->convertToFullColumnIfConst(); } }; /// Returns global default value for type of passed argument (example: 0 for numeric types, '' for String). class FunctionDefaultValueOfArgumentType : public IFunction { public: static constexpr auto name = "defaultValueOfArgumentType"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool useDefaultImplementationForNulls() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { return arguments[0]; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const IDataType & type = *block.getByPosition(arguments[0]).type; block.getByPosition(result).column = type.createColumnConst(block.rows(), type.getDefault()); } }; class FunctionBlockSize : public IFunction { public: static constexpr auto name = "blockSize"; static FunctionPtr create(const Context &) { return std::make_shared(); } /// Get the function name. String getName() const override { return name; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { size_t size = block.rows(); block.getByPosition(result).column = ColumnUInt64::create(size, size); } }; class FunctionRowNumberInBlock : public IFunction { public: static constexpr auto name = "rowNumberInBlock"; static FunctionPtr create(const Context &) { return std::make_shared(); } /// Get the name of the function. String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { size_t size = block.rows(); auto column = ColumnUInt64::create(); auto & data = column->getData(); data.resize(size); for (size_t i = 0; i < size; ++i) data[i] = i; block.getByPosition(result).column = std::move(column); } }; /** Incremental block number among calls of this function. */ class FunctionBlockNumber : public IFunction { private: mutable std::atomic block_number{0}; public: static constexpr auto name = "blockNumber"; static FunctionPtr create(const Context &) { return std::make_shared(); } /// Get the function name. String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { size_t current_block_number = block_number++; block.getByPosition(result).column = ColumnUInt64::create(block.rows(), current_block_number); } }; /** Incremental number of row within all blocks passed to this function. */ class FunctionRowNumberInAllBlocks : public IFunction { private: mutable std::atomic rows{0}; public: static constexpr auto name = "rowNumberInAllBlocks"; static FunctionPtr create(const Context &) { return std::make_shared(); } /// Get the name of the function. String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { size_t rows_in_block = block.rows(); size_t current_row_number = rows.fetch_add(rows_in_block); auto column = ColumnUInt64::create(); auto & data = column->getData(); data.resize(rows_in_block); for (size_t i = 0; i < rows_in_block; ++i) data[i] = current_row_number + i; block.getByPosition(result).column = std::move(column); } }; enum class FunctionSleepVariant { PerBlock, PerRow }; template class FunctionSleep : public IFunction { public: static constexpr auto name = variant == FunctionSleepVariant::PerBlock ? "sleep" : "sleepEachRow"; static FunctionPtr create(const Context &) { return std::make_shared>(); } /// Get the name of the function. String getName() const override { return name; } /// Do not sleep during query analysis. bool isSuitableForConstantFolding() const override { return false; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { if (!checkDataType(&*arguments[0]) && !checkDataType(&*arguments[0]) && !checkDataType(&*arguments[0]) && !checkDataType(&*arguments[0]) && !checkDataType(&*arguments[0]) && !checkDataType(&*arguments[0])) throw Exception( "Illegal type " + arguments[0]->getName() + " of argument of function " + getName() + ", expected Float64", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const IColumn * col = block.getByPosition(arguments[0]).column.get(); if (!col->isColumnConst()) throw Exception("The argument of function " + getName() + " must be constant.", ErrorCodes::ILLEGAL_COLUMN); Float64 seconds = applyVisitor(FieldVisitorConvertToNumber(), static_cast(*col).getField()); if (seconds < 0) throw Exception("Cannot sleep negative amount of time (not implemented)", ErrorCodes::BAD_ARGUMENTS); size_t size = col->size(); /// We do not sleep if the block is empty. if (size > 0) { unsigned useconds = seconds * (variant == FunctionSleepVariant::PerBlock ? 1 : size) * 1e6; /// When sleeping, the query cannot be cancelled. For abitily to cancel query, we limit sleep time. if (useconds > 3000000) /// The choice is arbitary throw Exception( "The maximum sleep time is 3000000 microseconds. Requested: " + toString(useconds), ErrorCodes::TOO_SLOW); usleep(useconds); } /// convertToFullColumn needed, because otherwise (constant expression case) function will not get called on each block. block.getByPosition(result).column = block.getByPosition(result) .type->createColumnConst(size, static_cast(0)) ->convertToFullColumnIfConst(); } }; class FunctionMaterialize : public IFunction { public: static constexpr auto name = "materialize"; static FunctionPtr create(const Context &) { return std::make_shared(); } /// Get the function name. String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { return arguments[0]; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const auto & src = block.getByPosition(arguments[0]).column; if (ColumnPtr converted = src->convertToFullColumnIfConst()) block.getByPosition(result).column = converted; else block.getByPosition(result).column = src; } }; template struct FunctionInName; template <> struct FunctionInName { static constexpr auto name = "in"; }; template <> struct FunctionInName { static constexpr auto name = "tidbIn"; }; template <> struct FunctionInName { static constexpr auto name = "globalIn"; }; template <> struct FunctionInName { static constexpr auto name = "notIn"; }; template <> struct FunctionInName { static constexpr auto name = "tidbNotIn"; }; template <> struct FunctionInName { static constexpr auto name = "globalNotIn"; }; template class FunctionIn : public IFunction { public: static constexpr auto name = FunctionInName::name; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 2; } DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override { if constexpr (ignore_null) return std::make_shared(); auto type = removeNullable(arguments[0].type); if (typeid_cast(type.get())) throw Exception( "Illegal type (" + arguments[0].type->getName() + ") of 1 argument of function " + getName(), ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); if (!typeid_cast(arguments[1].type.get())) throw Exception( "Illegal type (" + arguments[1].type->getName() + ") of 2 argument of function " + getName(), ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); bool return_nullable = arguments[0].type->isNullable(); ColumnPtr column_set_ptr = arguments[1].column; const auto * column_set = typeid_cast(&*column_set_ptr); return_nullable |= column_set->getData()->containsNullValue(); if (return_nullable) return makeNullable(std::make_shared()); else return std::make_shared(); } bool useDefaultImplementationForNulls() const override { return false; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const ColumnWithTypeAndName & left_arg = block.getByPosition(arguments[0]); if constexpr (!ignore_null) { if (left_arg.type->onlyNull()) { block.getByPosition(result).column = block.getByPosition(result).type->createColumnConst(block.rows(), Null()); return; } } /// Second argument must be ColumnSet. ColumnPtr column_set_ptr = block.getByPosition(arguments[1]).column; const auto * column_set = typeid_cast(&*column_set_ptr); if (!column_set) throw Exception( "Second argument for function '" + getName() + "' must be Set; found " + column_set_ptr->getName(), ErrorCodes::ILLEGAL_COLUMN); Block block_of_key_columns; /// First argument may be tuple or single column. const auto * tuple = typeid_cast(left_arg.column.get()); const ColumnConst * const_tuple = checkAndGetColumnConst(left_arg.column.get()); const auto * type_tuple = typeid_cast(left_arg.type.get()); ColumnPtr materialized_tuple; if (const_tuple) { materialized_tuple = const_tuple->convertToFullColumn(); tuple = typeid_cast(materialized_tuple.get()); } auto left_column_vector = left_arg.column; if (left_arg.column->isColumnConst()) { left_column_vector = left_column_vector->convertToFullColumnIfConst(); } if (tuple) { const Columns & tuple_columns = tuple->getColumns(); const DataTypes & tuple_types = type_tuple->getElements(); size_t tuple_size = tuple_columns.size(); for (size_t i = 0; i < tuple_size; ++i) block_of_key_columns.insert({tuple_columns[i], tuple_types[i], ""}); } else { if (left_arg.column->isColumnConst()) { block_of_key_columns.insert({left_column_vector, left_arg.type, ""}); } else { block_of_key_columns.insert(left_arg); } } if constexpr (ignore_null) { block.getByPosition(result).column = column_set->getData()->execute(block_of_key_columns, negative); } else { bool set_contains_null = column_set->getData()->containsNullValue(); bool return_nullable = left_arg.type->isNullable() || set_contains_null; if (return_nullable) { auto nested_res = column_set->getData()->execute(block_of_key_columns, negative); if (left_column_vector->isColumnNullable()) { ColumnPtr result_null_map_column = dynamic_cast(*left_column_vector).getNullMapColumnPtr(); if (set_contains_null) { MutableColumnPtr mutable_result_null_map_column = (*std::move(result_null_map_column)).mutate(); NullMap & result_null_map = dynamic_cast(*mutable_result_null_map_column).getData(); const auto * uint8_column = checkAndGetColumn(nested_res.get()); const auto & data = uint8_column->getData(); for (size_t i = 0, size = result_null_map.size(); i < size; i++) { if (data[i] == negative) result_null_map[i] = 1; } result_null_map_column = std::move(mutable_result_null_map_column); } block.getByPosition(result).column = ColumnNullable::create(nested_res, result_null_map_column); } else { auto col_null_map = ColumnUInt8::create(); ColumnUInt8::Container & vec_null_map = col_null_map->getData(); vec_null_map.assign(block.rows(), static_cast(0)); const auto * uint8_column = checkAndGetColumn(nested_res.get()); const auto & data = uint8_column->getData(); for (size_t i = 0, size = vec_null_map.size(); i < size; i++) { if (data[i] == negative) vec_null_map[i] = 1; } block.getByPosition(result).column = ColumnNullable::create(nested_res, std::move(col_null_map)); } } else { block.getByPosition(result).column = column_set->getData()->execute(block_of_key_columns, negative); } } } }; class FunctionIgnore : public IFunction { public: static constexpr auto name = "ignore"; static FunctionPtr create(const Context &) { return std::make_shared(); } bool isVariadic() const override { return true; } size_t getNumberOfArguments() const override { return 0; } bool useDefaultImplementationForNulls() const override { return false; } String getName() const override { return name; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { block.getByPosition(result).column = DataTypeUInt8().createColumnConst(block.rows(), static_cast(0)); } }; /** The `indexHint` function takes any number of any arguments and always returns one. * * This function has a special meaning (see ExpressionAnalyzer, KeyCondition) * - the expressions inside it are not evaluated; * - but when analyzing the index (selecting ranges for reading), this function is treated the same way, * as if instead of using it the expression itself would be. * * Example: WHERE something AND indexHint(CounterID = 34) * - do not read or calculate CounterID = 34, but select ranges in which the CounterID = 34 expression can be true. * * The function can be used for debugging purposes, as well as for (hidden from the user) query conversions. */ class FunctionIndexHint : public IFunction { public: static constexpr auto name = "indexHint"; static FunctionPtr create(const Context &) { return std::make_shared(); } bool isVariadic() const override { return true; } size_t getNumberOfArguments() const override { return 0; } bool useDefaultImplementationForNulls() const override { return false; } String getName() const override { return name; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { block.getByPosition(result).column = DataTypeUInt8().createColumnConst(block.rows(), static_cast(1)); } }; class FunctionIdentity : public IFunction { public: static constexpr auto name = "identity"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { return arguments.front(); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { block.getByPosition(result).column = block.getByPosition(arguments.front()).column; } }; FunctionPtr FunctionReplicate::create(const Context &) { return std::make_shared(); } DataTypePtr FunctionReplicate::getReturnTypeImpl(const DataTypes & arguments) const { const auto * array_type = checkAndGetDataType(&*arguments[1]); if (!array_type) throw Exception( "Second argument for function " + getName() + " must be array.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); return std::make_shared(arguments[0]); } void FunctionReplicate::executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const { ColumnPtr first_column = block.getByPosition(arguments[0]).column; const auto * array_column = checkAndGetColumn(block.getByPosition(arguments[1]).column.get()); ColumnPtr temp_column; if (!array_column) { const auto * const_array_column = checkAndGetColumnConst(block.getByPosition(arguments[1]).column.get()); if (!const_array_column) throw Exception("Unexpected column for replicate", ErrorCodes::ILLEGAL_COLUMN); temp_column = const_array_column->convertToFullColumn(); array_column = checkAndGetColumn(temp_column.get()); } block.getByPosition(result).column = ColumnArray::create(first_column->replicate(array_column->getOffsets()), array_column->getOffsetsPtr()); } /** Returns a string with nice Unicode-art bar with resolution of 1/8 part of symbol. */ class FunctionBar : public IFunction { public: static constexpr auto name = "bar"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } bool isVariadic() const override { return true; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { if (arguments.size() != 3 && arguments.size() != 4) throw Exception( "Function " + getName() + " requires from 3 or 4 parameters: value, min_value, max_value, [max_width_of_bar = 80]. Passed " + toString(arguments.size()) + ".", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH); if (!arguments[0]->isNumber() || !arguments[1]->isNumber() || !arguments[2]->isNumber() || (arguments.size() == 4 && !arguments[3]->isNumber())) throw Exception( "All arguments for function " + getName() + " must be numeric.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); return std::make_shared(); } bool useDefaultImplementationForConstants() const override { return true; } ColumnNumbers getArgumentsThatAreAlwaysConstant() const override { return {1, 2, 3}; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { auto min = extractConstant(block, arguments, 1, "Second"); /// The level at which the line has zero length. auto max = extractConstant( block, arguments, 2, "Third"); /// The level at which the line has the maximum length. /// The maximum width of the bar in characters, by default. Float64 max_width = arguments.size() == 4 ? extractConstant(block, arguments, 3, "Fourth") : 80; if (max_width < 1) throw Exception("Max_width argument must be >= 1.", ErrorCodes::ARGUMENT_OUT_OF_BOUND); if (max_width > 1000) throw Exception("Too large max_width.", ErrorCodes::ARGUMENT_OUT_OF_BOUND); const auto & src = *block.getByPosition(arguments[0]).column; auto res_column = ColumnString::create(); if (executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width) || executeNumber(src, *res_column, min, max, max_width)) { block.getByPosition(result).column = std::move(res_column); } else throw Exception( "Illegal column " + block.getByPosition(arguments[0]).column->getName() + " of argument of function " + getName(), ErrorCodes::ILLEGAL_COLUMN); } private: template T extractConstant(Block & block, const ColumnNumbers & arguments, size_t argument_pos, const char * which_argument) const { const auto & column = *block.getByPosition(arguments[argument_pos]).column; if (!column.isColumnConst()) throw Exception( which_argument + String(" argument for function ") + getName() + " must be constant.", ErrorCodes::ILLEGAL_COLUMN); return applyVisitor(FieldVisitorConvertToNumber(), column[0]); } template static void fill( const PaddedPODArray & src, ColumnString::Chars_t & dst_chars, ColumnString::Offsets & dst_offsets, Int64 min, Int64 max, Float64 max_width) { size_t size = src.size(); size_t current_offset = 0; dst_offsets.resize(size); dst_chars.reserve(size * (UnicodeBar::getWidthInBytes(max_width) + 1)); /// lines 0-terminated. for (size_t i = 0; i < size; ++i) { Float64 width = UnicodeBar::getWidth(src[i], min, max, max_width); size_t next_size = current_offset + UnicodeBar::getWidthInBytes(width) + 1; dst_chars.resize(next_size); UnicodeBar::render(width, reinterpret_cast(&dst_chars[current_offset])); current_offset = next_size; dst_offsets[i] = current_offset; } } template static void fill(T src, String & dst_chars, Int64 min, Int64 max, Float64 max_width) { Float64 width = UnicodeBar::getWidth(src, min, max, max_width); dst_chars.resize(UnicodeBar::getWidthInBytes(width)); UnicodeBar::render(width, &dst_chars[0]); } template static bool executeNumber(const IColumn & src, ColumnString & dst, Int64 min, Int64 max, Float64 max_width) { if (const auto * col = checkAndGetColumn>(&src)) { fill(col->getData(), dst.getChars(), dst.getOffsets(), min, max, max_width); return true; } else return false; } }; template class FunctionNumericPredicate : public IFunction { public: static constexpr auto name = Impl::name; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { if (!arguments.front()->isNumber()) throw Exception{ "Argument for function " + getName() + " must be number", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT}; return std::make_shared(); } bool useDefaultImplementationForConstants() const override { return true; } void executeImpl(Block & block, const ColumnNumbers & arguments, const size_t result) const override { const auto * const in = block.getByPosition(arguments.front()).column.get(); if (!execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result)) throw Exception{ "Illegal column " + in->getName() + " of first argument of function " + getName(), ErrorCodes::ILLEGAL_COLUMN}; } template bool execute(Block & block, const IColumn * in_untyped, const size_t result) const { if (const auto in = checkAndGetColumn>(in_untyped)) { const auto size = in->size(); auto out = ColumnUInt8::create(size); const auto & in_data = in->getData(); auto & out_data = out->getData(); for (const auto i : ext::range(0, size)) out_data[i] = Impl::execute(in_data[i]); block.getByPosition(result).column = std::move(out); return true; } return false; } }; struct IsFiniteImpl { /// Better implementation, because isinf, isfinite, isnan are not inlined for unknown reason. /// Assuming IEEE 754. /// NOTE gcc 7 doesn't vectorize this loop. static constexpr auto name = "isFinite"; template static bool execute(const T t) { if constexpr (std::is_same_v) return (ext::bit_cast(t) & 0b01111111100000000000000000000000) != 0b01111111100000000000000000000000; else if constexpr (std::is_same_v) return (ext::bit_cast(t) & 0b0111111111110000000000000000000000000000000000000000000000000000) != 0b0111111111110000000000000000000000000000000000000000000000000000; else { (void)t; return true; } } }; struct IsInfiniteImpl { static constexpr auto name = "isInfinite"; template static bool execute(const T t) { if constexpr (std::is_same_v) return (ext::bit_cast(t) & 0b01111111111111111111111111111111) == 0b01111111100000000000000000000000; else if constexpr (std::is_same_v) return (ext::bit_cast(t) & 0b0111111111111111111111111111111111111111111111111111111111111111) == 0b0111111111110000000000000000000000000000000000000000000000000000; else { (void)t; return false; } } }; struct IsNaNImpl { static constexpr auto name = "isNaN"; template static bool execute(const T t) { return t != t; } }; using FunctionIsFinite = FunctionNumericPredicate; using FunctionIsInfinite = FunctionNumericPredicate; using FunctionIsNaN = FunctionNumericPredicate; /** Returns server version (constant). */ class FunctionVersion : public IFunction { public: static constexpr auto name = "version"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { static const std::string version = getVersion(); block.getByPosition(result).column = DataTypeString().createColumnConst(block.rows(), version); } private: static std::string getVersion(); }; /** Returns server uptime in seconds. */ class FunctionUptime : public IFunction { public: static constexpr auto name = "uptime"; static FunctionPtr create(const Context & context) { return std::make_shared(context.getUptimeSeconds()); } explicit FunctionUptime(time_t uptime_) : uptime(uptime_) {} String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } bool isDeterministic() const override { return false; } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { block.getByPosition(result).column = DataTypeUInt32().createColumnConst(block.rows(), static_cast(uptime)); } private: time_t uptime; }; /** Returns the server time zone. */ class FunctionTimeZone : public IFunction { public: static constexpr auto name = "timezone"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 0; } DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override { return std::make_shared(); } bool isDeterministic() const override { return false; } void executeImpl(Block & block, const ColumnNumbers & /*arguments*/, size_t result) const override { block.getByPosition(result).column = DataTypeString().createColumnConst(block.rows(), DateLUT::instance().getTimeZone()); } }; /** Quite unusual function. * Takes state of aggregate function (example runningAccumulate(uniqState(UserID))), * and for each row of block, return result of aggregate function on merge of states of all previous rows and current row. * * So, result of function depends on partition of data to blocks and on order of data in block. */ class FunctionRunningAccumulate : public IFunction { public: static constexpr auto name = "runningAccumulate"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } bool isDeterministic() const override { return false; } bool isDeterministicInScopeOfQuery() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { const auto * type = checkAndGetDataType(&*arguments[0]); if (!type) throw Exception( "Argument for function " + getName() + " must have type AggregateFunction - state of aggregate function.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); return type->getReturnType(); } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { const auto * column_with_states = typeid_cast(&*block.getByPosition(arguments.at(0)).column); if (!column_with_states) throw Exception( "Illegal column " + block.getByPosition(arguments.at(0)).column->getName() + " of first argument of function " + getName(), ErrorCodes::ILLEGAL_COLUMN); AggregateFunctionPtr aggregate_function_ptr = column_with_states->getAggregateFunction(); const IAggregateFunction & agg_func = *aggregate_function_ptr; auto deleter = [&agg_func](char * ptr) { agg_func.destroy(ptr); free(ptr); // NOLINT(cppcoreguidelines-no-malloc) }; std::unique_ptr place{ reinterpret_cast(malloc(agg_func.sizeOfData())), // NOLINT(cppcoreguidelines-no-malloc) deleter}; agg_func.create( place.get()); /// Not much exception-safe. If an exception is thrown out, destroy will be called in vain. std::unique_ptr arena = agg_func.allocatesMemoryInArena() ? std::make_unique() : nullptr; auto result_column_ptr = agg_func.getReturnType()->createColumn(); IColumn & result_column = *result_column_ptr; result_column.reserve(column_with_states->size()); const auto & states = column_with_states->getData(); for (const auto & state_to_add : states) { /// Will pass empty arena if agg_func does not allocate memory in arena agg_func.merge(place.get(), state_to_add, arena.get()); agg_func.insertResultInto(place.get(), result_column, arena.get()); } block.getByPosition(result).column = std::move(result_column_ptr); } }; template struct FunctionRunningDifferenceName; template <> struct FunctionRunningDifferenceName { static constexpr auto name = "runningDifference"; }; template <> struct FunctionRunningDifferenceName { static constexpr auto name = "runningDifferenceStartingWithFirstValue"; }; /** Calculate difference of consecutive values in block. * So, result of function depends on partition of data to blocks and on order of data in block. */ template class FunctionRunningDifferenceImpl : public IFunction { private: /// It is possible to track value from previous block, to calculate continuously across all blocks. Not implemented. template static void process(const PaddedPODArray & src, PaddedPODArray & dst) { size_t size = src.size(); dst.resize(size); if (size == 0) return; /// It is possible to SIMD optimize this loop. By no need for that in practice. dst[0] = is_first_line_zero ? 0 : src[0]; Src prev = src[0]; for (size_t i = 1; i < size; ++i) { auto cur = src[i]; dst[i] = static_cast(cur) - prev; prev = cur; } } /// Result type is same as result of subtraction of argument types. template using DstFieldType = typename NumberTraits::ResultOfSubtraction::Type; /// Call polymorphic lambda with tag argument of concrete field type of src_type. template void dispatchForSourceType(const IDataType & src_type, F && f) const { if (checkDataType(&src_type)) f(UInt8()); else if (checkDataType(&src_type)) f(UInt16()); else if (checkDataType(&src_type)) f(UInt32()); else if (checkDataType(&src_type)) f(UInt64()); else if (checkDataType(&src_type)) f(Int8()); else if (checkDataType(&src_type)) f(Int16()); else if (checkDataType(&src_type)) f(Int32()); else if (checkDataType(&src_type)) f(Int64()); else if (checkDataType(&src_type)) f(Float32()); else if (checkDataType(&src_type)) f(Float64()); else if (checkDataType(&src_type)) f(DataTypeDate::FieldType()); else if (checkDataType(&src_type)) f(DataTypeDateTime::FieldType()); else throw Exception( "Argument for function " + getName() + " must have numeric type.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); } public: static constexpr auto name = FunctionRunningDifferenceName::name; static FunctionPtr create(const Context &) { return std::make_shared>(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } bool isDeterministicInScopeOfQuery() const override { return false; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { DataTypePtr res; dispatchForSourceType(*arguments[0], [&](auto field_type_tag) { res = std::make_shared>>(); }); return res; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override { auto & src = block.getByPosition(arguments.at(0)); const auto & res_type = block.getByPosition(result).type; /// When column is constant, its difference is zero. if (src.column->isColumnConst()) { block.getByPosition(result).column = res_type->createColumnConstWithDefaultValue(block.rows()); return; } auto res_column = res_type->createColumn(); dispatchForSourceType(*src.type, [&](auto field_type_tag) { using SrcFieldType = decltype(field_type_tag); process( static_cast &>(*src.column).getData(), static_cast> &>(*res_column).getData()); }); block.getByPosition(result).column = std::move(res_column); } }; using FunctionRunningDifference = FunctionRunningDifferenceImpl; using FunctionRunningIncome = FunctionRunningDifferenceImpl; /** Usage: * hasColumnInTable(['hostname'[, 'username'[, 'password']],] 'database', 'table', 'column') */ class FunctionHasColumnInTable : public IFunction { public: static constexpr auto name = "hasColumnInTable"; static FunctionPtr create(const Context & context) { return std::make_shared(context.getGlobalContext()); } explicit FunctionHasColumnInTable(const Context & global_context_) : global_context(global_context_) {} bool isVariadic() const override { return true; } size_t getNumberOfArguments() const override { return 0; } String getName() const override { return name; } DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override; bool isDeterministic() const override { return false; } void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const override; private: const Context & global_context; }; void FunctionVisibleWidth::executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const { auto & src = block.getByPosition(arguments[0]); size_t size = block.rows(); auto res_col = ColumnUInt64::create(size); auto & res_data = static_cast(*res_col).getData(); /// For simplicity reasons, function is implemented by serializing into temporary buffer. String tmp; for (size_t i = 0; i < size; ++i) { { WriteBufferFromString out(tmp); src.type->serializeTextEscaped(*src.column, i, out); } res_data[i] = UTF8::countCodePoints(reinterpret_cast(tmp.data()), tmp.size()); } block.getByPosition(result).column = std::move(res_col); } DataTypePtr FunctionHasColumnInTable::getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const { if (arguments.size() < 3 || arguments.size() > 6) throw Exception{ "Invalid number of arguments for function " + getName(), ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH}; static const std::string arg_pos_description[] = {"First", "Second", "Third", "Fourth", "Fifth", "Sixth"}; for (size_t i = 0; i < arguments.size(); ++i) { const ColumnWithTypeAndName & argument = arguments[i]; if (!checkColumnConst(argument.column.get())) { throw Exception( arg_pos_description[i] + " argument for function " + getName() + " must be const String.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT); } } return std::make_shared(); } void FunctionHasColumnInTable::executeImpl(Block & block, const ColumnNumbers & arguments, size_t result) const { auto get_string_from_block = [&](size_t column_pos) -> String { ColumnPtr column = block.getByPosition(column_pos).column; const ColumnConst * const_column = checkAndGetColumnConst(column.get()); return const_column->getValue(); }; size_t arg = 0; String host_name; String user_name; String password; if (arguments.size() > 3) host_name = get_string_from_block(arguments[arg++]); if (arguments.size() > 4) user_name = get_string_from_block(arguments[arg++]); if (arguments.size() > 5) password = get_string_from_block(arguments[arg++]); String database_name = get_string_from_block(arguments[arg++]); String table_name = get_string_from_block(arguments[arg++]); String column_name = get_string_from_block(arguments[arg++]); bool has_column = false; if (host_name.empty()) { const StoragePtr & table = global_context.getTable(database_name, table_name); has_column = table->hasColumn(column_name); } block.getByPosition(result).column = DataTypeUInt8().createColumnConst(block.rows(), static_cast(has_column)); } /// Throw an exception if the argument is non zero. class FunctionThrowIf : public IFunction { public: static constexpr auto name = "throwIf"; static FunctionPtr create(const Context &) { return std::make_shared(); } String getName() const override { return name; } size_t getNumberOfArguments() const override { return 1; } DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override { if (!arguments.front()->isNumber()) throw Exception{ "Argument for function " + getName() + " must be number", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT}; return std::make_shared(); } bool useDefaultImplementationForConstants() const override { return true; } void executeImpl(Block & block, const ColumnNumbers & arguments, const size_t result) const override { const auto * const in = block.getByPosition(arguments.front()).column.get(); if (!execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result) && !execute(block, in, result)) throw Exception{ "Illegal column " + in->getName() + " of first argument of function " + getName(), ErrorCodes::ILLEGAL_COLUMN}; } template bool execute(Block & block, const IColumn * in_untyped, const size_t result) const { if (const auto in = checkAndGetColumn>(in_untyped)) { const auto & in_data = in->getData(); if (!mem_utils::memoryIsZero(in_data.data(), in_data.size() * sizeof(in_data[0]))) throw Exception( "Value passed to 'throwIf' function is non zero", ErrorCodes::FUNCTION_THROW_IF_VALUE_IS_NON_ZERO); /// We return non constant to avoid constant folding. block.getByPosition(result).column = ColumnUInt8::create(in_data.size(), 0); return true; } return false; } }; std::string FunctionVersion::getVersion() { std::ostringstream os; os << TiFlashBuildInfo::getReleaseVersion(); return os.str(); } void registerFunctionsMiscellaneous(FunctionFactory & factory) { factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction>(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); factory.registerFunction(); } } // namespace DB