ClickHouse/dbms/include/DB/TableFunctions/ITableFunction.h

#pragma once

#include <Poco/SharedPtr.h>

#include <DB/Storages/IStorage.h>
#include <DB/Parsers/ASTFunction.h>
#include <DB/Interpreters/Context.h>

namespace DB
{

/** Интерфейс для табличных функций.
  *
  * Табличные функции не имеют отношения к другим функциям.
  * Табличная функция может быть указана в секции FROM вместо [db.]table
  * Табличная функция возвращает временный объект StoragePtr, который используется для выполнения запроса.
  *
  * Пример:
  * SELECT count() FROM remote('example01-01-1', merge, hits)
  * - пойти на example01-01-1, в БД merge, таблицу hits.
  */

class ITableFunction
{
public:
	/// Получить основное имя функции.
	virtual std::string getName() const = 0;

	/// Создать storage в соответствии с запросом
	virtual StoragePtr execute(ASTPtr ast_function, Context & context) const = 0;

	virtual ~ITableFunction() {};
};

typedef SharedPtr<ITableFunction> TableFunctionPtr;


}