Merge テーブルエンジン

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

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

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

​

テーブルの作成

CREATE TABLE ... Engine=Merge(db_name, tables_regexp)

​

エンジンパラメータ

​

db_name

db_name — 設定可能な値:

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

​

tables_regexp

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

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

​

使用法

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

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

​

例

例 1

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

CREATE TABLE all_visitors (id UInt32) ENGINE=Merge(REGEXP('ABC_*'), 'visitors');

例 2

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

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;

┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-01 │      1 │ hit       │   3 │
└────────────┴────────┴───────────┴─────┘
┌───────date─┬─UserId─┬─EventType─┬─Cnt─┐
│ 2018-01-02 │      2 │ hit       │   3 │
└────────────┴────────┴───────────┴─────┘

​

仮想カラム

• _table — データの読み取り元であるテーブルの名前です。型: String.

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

• _database — データの読み取り元であるデータベースの名前が含まれます。型: String.

関連項目

• 仮想カラム
• merge テーブル関数