ClickHouse/dbms/include/DB/Core/Block.h

158 lines
5.6 KiB
C++
Raw Normal View History

2011-08-09 15:57:33 +00:00
#pragma once
2010-03-01 16:59:51 +00:00
#include <vector>
#include <map>
2014-09-12 16:05:29 +00:00
#include <initializer_list>
2010-03-01 16:59:51 +00:00
2016-07-24 21:34:09 +00:00
#include <DB/Common/Exception.h>
#include <DB/Core/BlockInfo.h>
2011-11-06 02:29:13 +00:00
#include <DB/Core/NamesAndTypes.h>
2016-08-04 21:40:20 +00:00
#include <DB/Core/ColumnWithTypeAndName.h>
#include <DB/Core/ColumnsWithTypeAndName.h>
2016-07-24 21:34:09 +00:00
#include <DB/Core/ColumnNumbers.h>
2016-08-04 21:40:20 +00:00
#include <DB/Common/Exception.h>
2010-03-01 16:59:51 +00:00
namespace DB
{
/** Тип данных для представления подмножества строк и столбцов в оперативке.
* Содержит также метаданные (типы) столбцов и их имена.
* Позволяет вставлять, удалять столбцы в любом порядке, менять порядок столбцов.
*/
class Context;
2010-03-01 16:59:51 +00:00
class Block
{
private:
2016-08-04 21:40:20 +00:00
using Container = std::vector<ColumnWithTypeAndName>;
using IndexByName = std::map<String, size_t>;
Container data;
IndexByName index_by_name;
2010-03-01 16:59:51 +00:00
public:
BlockInfo info;
2014-09-12 16:05:29 +00:00
Block() = default;
Block(std::initializer_list<ColumnWithTypeAndName> il) : data{il}
2014-09-12 16:05:29 +00:00
{
2016-08-04 21:40:20 +00:00
size_t i = 0;
for (const auto & elem : il)
2014-09-12 16:05:29 +00:00
{
2016-08-04 21:40:20 +00:00
index_by_name[elem.name] = i;
++i;
2014-09-12 16:05:29 +00:00
}
}
2010-03-05 15:29:17 +00:00
/// вставить столбец в заданную позицию
void insert(size_t position, const ColumnWithTypeAndName & elem);
2016-08-04 21:40:20 +00:00
void insert(size_t position, ColumnWithTypeAndName && elem);
2010-03-05 15:29:17 +00:00
/// вставить столбец в конец
void insert(const ColumnWithTypeAndName & elem);
2016-08-04 21:40:20 +00:00
void insert(ColumnWithTypeAndName && elem);
2011-09-04 05:14:52 +00:00
/// вставить столбец в конец, если столбца с таким именем ещё нет
void insertUnique(const ColumnWithTypeAndName & elem);
2016-08-04 21:40:20 +00:00
void insertUnique(ColumnWithTypeAndName && elem);
2010-03-05 15:29:17 +00:00
/// удалить столбец в заданной позиции
2010-03-01 16:59:51 +00:00
void erase(size_t position);
/// удалить столбец с заданным именем
void erase(const String & name);
/// Добавляет в блок недостающие столбцы со значениями по-умолчанию
2014-10-16 16:55:23 +00:00
void addDefaults(const NamesAndTypesList & required_columns);
2010-03-01 16:59:51 +00:00
2016-08-04 21:40:20 +00:00
/// References are invalidated after calling functions above.
ColumnWithTypeAndName & getByPosition(size_t position);
const ColumnWithTypeAndName & getByPosition(size_t position) const;
2010-03-01 16:59:51 +00:00
2016-08-04 21:40:20 +00:00
ColumnWithTypeAndName & unsafeGetByPosition(size_t position) { return data[position]; }
const ColumnWithTypeAndName & unsafeGetByPosition(size_t position) const { return data[position]; }
ColumnWithTypeAndName & getByName(const std::string & name);
const ColumnWithTypeAndName & getByName(const std::string & name) const;
2010-03-01 16:59:51 +00:00
2011-12-12 06:15:34 +00:00
bool has(const std::string & name) const;
2011-08-12 20:39:42 +00:00
size_t getPositionByName(const std::string & name) const;
ColumnsWithTypeAndName getColumns() const;
2011-11-06 02:29:13 +00:00
NamesAndTypesList getColumnsList() const;
2010-03-04 19:20:28 +00:00
/** Возвращает количество строк в блоке.
2013-06-08 20:19:29 +00:00
* Заодно проверяет, что все столбцы содержат одинаковое число значений.
2010-03-04 19:20:28 +00:00
*/
size_t rows() const;
2013-06-08 20:19:29 +00:00
/** То же самое, но без проверки - берёт количество строк из первого столбца, если он есть или возвращает 0.
*/
size_t rowsInFirstColumn() const;
2016-08-04 21:40:20 +00:00
size_t columns() const { return data.size(); }
2010-03-04 19:20:28 +00:00
2012-05-17 19:15:53 +00:00
/// Приблизительное количество байт в оперативке - для профайлинга.
size_t bytes() const;
2016-08-04 21:40:20 +00:00
operator bool() const { return !data.empty(); }
bool operator!() const { return data.empty(); }
2011-08-14 00:49:30 +00:00
/** Получить список имён столбцов через запятую. */
std::string dumpNames() const;
2011-09-19 03:34:23 +00:00
/** Список имен, типов и длин столбцов. Предназначен для отладки. */
std::string dumpStructure() const;
2011-09-19 03:34:23 +00:00
/** Получить такой же блок, но пустой. */
Block cloneEmpty() const;
/** Получить блок со столбцами, переставленными в порядке их имён. */
Block sortColumns() const;
/** Заменяет столбцы смещений внутри вложенных таблиц на один общий для таблицы.
* Кидает исключение, если эти смещения вдруг оказались неодинаковы.
*/
void optimizeNestedArraysOffsets();
/** Тоже самое, только без замены смещений. */
void checkNestedArraysOffsets() const;
void clear();
2016-05-30 20:54:39 +00:00
void swap(Block & other) noexcept;
/** Some column implementations (ColumnArray) may have shared parts between different columns
* (common array sizes of elements of nested data structures).
* Before doing mutating operations on such columns, you must unshare that parts.
* Also unsharing columns, if whole columns are shared_ptrs pointing to same instances.
*/
void unshareColumns();
2016-08-04 21:40:20 +00:00
private:
void eraseImpl(size_t position);
2010-03-01 16:59:51 +00:00
};
using Blocks = std::vector<Block>;
using BlocksList = std::list<Block>;
2012-07-17 20:04:39 +00:00
/// Сравнить типы столбцов у блоков. Порядок столбцов имеет значение. Имена не имеют значения.
bool blocksHaveEqualStructure(const Block & lhs, const Block & rhs);
2015-10-12 14:53:16 +00:00
/** Дополнительные данные к блокам. Они пока нужны только для запроса
* DESCRIBE TABLE с Distributed-таблицами.
*/
struct BlockExtraInfo
{
BlockExtraInfo() {}
operator bool() const { return is_valid; }
bool operator!() const { return !is_valid; }
std::string host;
std::string resolved_address;
std::string user;
UInt16 port = 0;
bool is_valid = false;
};
2010-03-01 16:59:51 +00:00
}