2020-10-26 10:29:30 +00:00
---
toc_priority: 36
toc_title: Merge
---
2020-03-20 18:20:59 +00:00
# Merge {#merge}
2017-03-12 17:58:51 +00:00
2018-04-28 11:45:37 +00:00
Движок `Merge` (не путайте с движком `MergeTree` ) не хранит данные самостоятельно, а позволяет читать одновременно из произвольного количества других таблиц.
2017-03-12 17:58:51 +00:00
Чтение автоматически распараллеливается. Запись в таблицу не поддерживается. При чтении будут использованы индексы тех таблиц, из которых реально идёт чтение, если они существуют.
2017-06-13 20:35:07 +00:00
2021-11-01 10:39:25 +00:00
## Создание таблицы {#creating-a-table}
2018-04-28 11:45:37 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2021-11-02 09:01:01 +00:00
CREATE TABLE ... Engine=Merge(db_name, tables_regexp)
2017-10-25 05:27:09 +00:00
```
2017-05-08 05:06:04 +00:00
2021-11-01 10:39:25 +00:00
**Параметры движка**
2017-03-12 17:58:51 +00:00
2021-11-02 14:29:20 +00:00
- `db_name` — Возможные варианты:
- имя БД,
- выражение, возвращающее строку с именем БД, например, `currentDatabase()` ,
- `REGEXP(expression)` , где `expression` — регулярное выражение для отбора БД.
2021-11-01 10:39:25 +00:00
- `tables_regexp` — регулярное выражение для имен таблиц в указанной БД или нескольких БД.
## Использование {#usage}
2017-03-12 17:58:51 +00:00
2018-03-15 18:44:04 +00:00
Регулярные выражения — [re2 ](https://github.com/google/re2 ) (поддерживает подмножество PCRE), регистрозависимые.
2020-03-20 18:20:59 +00:00
Смотрите замечание о б экранировании в регулярных выражениях в разделе «match».
2017-03-12 17:58:51 +00:00
2021-11-01 10:39:25 +00:00
При выборе таблиц для чтения сама `Merge` -таблица не будет выбрана, даже если попадает под регулярное выражение, чтобы не возникло циклов.
Впрочем, вы можете создать две `Merge` -таблицы, которые будут пытаться бесконечно читать данные друг друга, но делать этого не рекомендуется.
Типичный способ использования движка `Merge` — работа с большим количеством таблиц типа `TinyLog` как с одной.
**Пример 1**
2017-03-12 17:58:51 +00:00
2021-11-01 10:39:25 +00:00
Пусть есть две БД `ABC_corporate_site` и `ABC_store` . Таблица `all_visitors` будет содержать ID из таблиц `visitors` в обеих БД.
2017-03-12 17:58:51 +00:00
2021-11-01 10:39:25 +00:00
``` sql
CREATE TABLE all_visitors (id UInt32) ENGINE=Merge(REGEXP('ABC_*'), 'visitors');
```
**Пример 2**
2018-11-01 13:28:45 +00:00
Пусть есть старая таблица `WatchLog_old` . Необходимо изменить партиционирование без перемещения данных в новую таблицу `WatchLog_new` . При этом в выборке должны участвовать данные обеих таблиц.
2020-03-20 18:20:59 +00:00
``` sql
CREATE TABLE WatchLog_old(date Date, UserId Int64, EventType String, Cnt UInt64)
2021-11-01 10:39:25 +00:00
ENGINE=MergeTree(date, (UserId, EventType), 8192);
2018-11-01 13:28:45 +00:00
INSERT INTO WatchLog_old VALUES ('2018-01-01', 1, 'hit', 3);
CREATE TABLE WatchLog_new(date Date, UserId Int64, EventType String, Cnt UInt64)
2021-11-01 10:39:25 +00:00
ENGINE=MergeTree PARTITION BY date ORDER BY (UserId, EventType) SETTINGS index_granularity=8192;
2018-11-01 13:28:45 +00:00
INSERT INTO WatchLog_new VALUES ('2018-01-02', 2, 'hit', 3);
CREATE TABLE WatchLog as WatchLog_old ENGINE=Merge(currentDatabase(), '^WatchLog');
2021-11-01 10:39:25 +00:00
SELECT * FROM WatchLog;
2019-09-23 15:31:46 +00:00
```
2020-03-20 18:20:59 +00:00
``` text
2018-11-01 13:28:45 +00:00
┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-01 │ 1 │ hit │ 3 │
└────────────┴────────┴───────────┴─────┘
┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-02 │ 2 │ hit │ 3 │
└────────────┴────────┴───────────┴─────┘
```
2020-03-20 18:20:59 +00:00
## Виртуальные столбцы {#virtualnye-stolbtsy}
2017-03-12 17:58:51 +00:00
2020-04-30 18:19:18 +00:00
- `_table` — содержит имя таблицы, из которой данные были прочитаны. Тип — [String ](../../../engines/table-engines/special/merge.md ).
2017-03-12 17:58:51 +00:00
2020-03-21 04:11:51 +00:00
В секции `WHERE/PREWHERE` можно установить константное условие на столбец `_table` (например, `WHERE _table='xyz'` ). В этом случае операции чтения выполняются только для тех таблиц, для которых выполняется условие на значение `_table` , таким образом, столбец `_table` работает как индекс.
2017-10-25 05:27:09 +00:00
2021-11-01 10:39:25 +00:00
**См. также**
2017-03-12 17:58:51 +00:00
2020-03-21 04:11:51 +00:00
- [Виртуальные столбцы ](index.md#table_engines-virtual_columns )
2021-11-01 10:39:25 +00:00
- Табличная функция [merge ](../../../sql-reference/table-functions/merge.md )