mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-30 11:32:03 +00:00
54 lines
2.7 KiB
C++
54 lines
2.7 KiB
C++
#pragma once
|
|
|
|
#include <Poco/SharedPtr.h>
|
|
|
|
#include <DB/Core/Names.h>
|
|
#include <DB/Core/Block.h>
|
|
#include <DB/Core/ColumnNumbers.h>
|
|
#include <DB/DataTypes/IDataType.h>
|
|
|
|
|
|
namespace DB
|
|
{
|
|
|
|
/** Интерфейс для обычных функций.
|
|
* Обычные функции - это функции, которые не меняют количество строк в таблице,
|
|
* и результат работы которых для каждой строчки не зависит от других строк.
|
|
*
|
|
* Функция может принимать произвольное количество аргументов и возвращать произвольное количество значений.
|
|
* Типы и количество значений результата зависят от типов и количества аргументов.
|
|
*
|
|
* Функция диспетчеризуется для целого блока. Это позволяет производить всевозможные проверки редко,
|
|
* и делать основную работу в виде эффективного цикла.
|
|
*
|
|
* Функция применяется к одному или нескольким столбцам блока, и записывает свой результат,
|
|
* добавляя новые столбцы к блоку. Функция не модифицирует свои агрументы.
|
|
*/
|
|
class IFunction
|
|
{
|
|
public:
|
|
/// Получить основное имя функции.
|
|
virtual String getName() const = 0;
|
|
|
|
/// Получить тип результата по типам аргументов. Если функция неприменима для данных аргументов - кинуть исключение.
|
|
virtual DataTypePtr getReturnType(const DataTypes & arguments) const = 0;
|
|
|
|
/// Вызывается, если хоть один агрумент функции - лямбда-выражение.
|
|
/// Для аргументов-лямбда-выражений определяет типы аргументов этих выражений и кладет результат в arguments.
|
|
virtual void getLambdaArgumentTypes(DataTypes & arguments) const
|
|
{
|
|
throw Exception("Function " + getName() + " can't have lambda-expressions as arguments", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
|
|
}
|
|
|
|
/// Выполнить функцию над блоком. Замечание: может вызываться одновременно из нескольких потоков, для одного объекта.
|
|
virtual void execute(Block & block, const ColumnNumbers & arguments, size_t result) = 0;
|
|
};
|
|
|
|
|
|
using Poco::SharedPtr;
|
|
|
|
typedef SharedPtr<IFunction> FunctionPtr;
|
|
|
|
|
|
}
|