> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> `Merge` エンジン（`MergeTree` と混同しないでください）は、それ自体ではデータを保存せず、任意の数の他のテーブルから同時に読み取ることができます。

# Merge テーブルエンジン

`Merge` エンジン (`MergeTree` と混同しないでください) は、それ自体ではデータを保存せず、任意の数の他のテーブルから同時に読み取ることができます。

読み取りは自動的に並列化されます。テーブルへの書き込みはサポートされていません。読み取り時には、実際に読み取られるテーブルに索引が存在する場合、それらが使用されます。

<div id="creating-a-table">
  ## テーブルの作成
</div>

```sql theme={null}
CREATE TABLE ... Engine=Merge(db_name, tables_regexp)
```

<div id="engine-parameters">
  ## エンジンパラメータ
</div>

<div id="db_name">
  ### `db_name`
</div>

`db_name` — 設定可能な値:

* データベース名、
  * データベース名を表す文字列を返す定数式。たとえば `currentDatabase()`、
  * `REGEXP(expression)`。ここで `expression` は DB 名に一致する正規表現です。

<div id="tables_regexp">
  ### `tables_regexp`
</div>

`tables_regexp` — 指定したDBまたは複数のDB内のテーブル名にマッチさせるための正規表現です。

正規表現 — [re2](https://github.com/google/re2) (PCRE の一部をサポート) で、大文字と小文字は区別されます。
正規表現内での記号のエスケープについては、「match」セクションの注記を参照してください。

<div id="usage">
  ## 使用法
</div>

読み取るテーブルを選択する際、`Merge` テーブル自体は、正規表現に一致していても選択されません。これはループを避けるためです。
互いのデータを無限に読み取ろうとする 2 つの `Merge` テーブルを作成することは可能ですが、これは良い考えではありません。

`Merge` エンジンの一般的な使い方は、多数の `TinyLog` テーブルを 1 つのテーブルのように扱うことです。

<div id="examples">
  ## 例
</div>

**例 1**

`ABC_corporate_site` と `ABC_store` という 2 つのデータベースを考えます。`all_visitors` テーブルには、両方のデータベース内の `visitors` テーブルの ID が含まれます。

```sql theme={null}
CREATE TABLE all_visitors (id UInt32) ENGINE=Merge(REGEXP('ABC_*'), 'visitors');
```

**例 2**

古いテーブル `WatchLog_old` があり、データを新しいテーブル `WatchLog_new` に移動せずにパーティション化を変更したとします。このとき、両方のテーブルのデータを参照する必要があります。

```sql theme={null}
CREATE TABLE WatchLog_old(
    date Date,
    UserId Int64,
    EventType String,
    Cnt UInt64
)
ENGINE=MergeTree
ORDER BY (date, UserId, EventType);

INSERT INTO WatchLog_old VALUES ('2018-01-01', 1, 'hit', 3);

CREATE TABLE WatchLog_new(
    date Date,
    UserId Int64,
    EventType String,
    Cnt UInt64
)
ENGINE=MergeTree
PARTITION BY date
ORDER BY (UserId, EventType)
SETTINGS index_granularity=8192;

INSERT INTO WatchLog_new VALUES ('2018-01-02', 2, 'hit', 3);

CREATE TABLE WatchLog AS WatchLog_old ENGINE=Merge(currentDatabase(), '^WatchLog');

SELECT * FROM WatchLog;
```

```text theme={null}
┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-01 │      1 │ hit       │   3 │
└────────────┴────────┴───────────┴─────┘
┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-02 │      2 │ hit       │   3 │
└────────────┴────────┴───────────┴─────┘
```

<div id="virtual-columns">
  ## 仮想カラム
</div>

* `_table` — データの読み取り元であるテーブルの名前です。型: [String](/ja/reference/data-types/string).

  `_table` でフィルタすると (たとえば `WHERE _table='xyz'`) 、フィルタ条件を満たすテーブルだけが読み取られます。

* `_database` — データの読み取り元であるデータベースの名前が含まれます。型: [String](/ja/reference/data-types/string).

**関連項目**

* [仮想カラム](/ja/reference/engines/table-engines#table_engines-virtual_columns)
* [merge](/ja/reference/functions/table-functions/merge) テーブル関数