Alias エンジンは、別のテーブルへのプロキシを作成します。読み取りおよび書き込みの操作はすべてターゲットテーブルに転送され、エイリアス自体はデータを保存せず、ターゲットテーブルへの参照のみを保持します。
CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_table)
CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_db, target_table)
Alias テーブルでは、カラムを明示的に定義することはできません。カラムはターゲットテーブルから自動的に継承されます。これにより、エイリアスは常にターゲットテーブルのスキーマと一致します。
target_db (optional) — ターゲットテーブルを含むデータベース名。target_table — ターゲットテーブル名。
target_db を省略し、target_table が完全修飾名でない場合 (例: Alias('my_table')) 、ターゲットはセッションの現在のデータベースではなく、エイリアス自体と同じデータベースとして解決されます。
Alias テーブルエンジンは、主要な操作をすべてサポートしています。
以下の操作はターゲットテーブルに委譲されます。
| 操作 | サポート | 説明 |
|---|
SELECT | ✅ | ターゲットテーブルからデータを読み取る |
INSERT | ✅ | ターゲットテーブルにデータを書き込む |
INSERT SELECT | ✅ | ターゲットテーブルに一括挿入する |
ALTER TABLE ADD COLUMN | ✅ | ターゲットテーブルにカラムを追加する |
ALTER TABLE MODIFY SETTING | ✅ | ターゲットテーブル設定を変更する |
ALTER TABLE PARTITION | ✅ | ターゲットテーブルに対するパーティション操作 (DETACH/ATTACH/DROP) |
ALTER TABLE UPDATE | ✅ | ターゲットテーブルの行を更新する (mutation) |
ALTER TABLE DELETE | ✅ | ターゲットテーブルの行を削除する (mutation) |
OPTIMIZE TABLE | ✅ | ターゲットテーブルを最適化する (パーツをマージ) |
TRUNCATE TABLE | ✅ | ターゲットテーブルをTRUNCATEする |
| 操作 | サポート | 説明 |
|---|
DROP TABLE | ✅ | エイリアスのみを削除し、ターゲットテーブルは変更されません |
RENAME TABLE | ✅ | エイリアス名のみを変更し、ターゲットテーブルは変更されません |
-- ソーステーブルを作成
CREATE TABLE source_data (
id UInt32,
name String,
value Float64
) ENGINE = MergeTree
ORDER BY id;
-- データを挿入
INSERT INTO source_data VALUES (1, 'one', 10.1), (2, 'two', 20.2);
-- エイリアスを作成
CREATE TABLE data_alias ENGINE = Alias('source_data');
-- エイリアス経由でクエリを実行
SELECT * FROM data_alias;
┌─id─┬─name─┬─value─┐
│ 1 │ one │ 10.1 │
│ 2 │ two │ 20.2 │
└────┴──────┴───────┘
-- データベースを作成する
CREATE DATABASE db1;
CREATE DATABASE db2;
-- db1 にソーステーブルを作成する
CREATE TABLE db1.events (
timestamp DateTime,
event_type String,
user_id UInt32
) ENGINE = MergeTree
ORDER BY timestamp;
-- db1.events を指す別名を db2 に作成する
CREATE TABLE db2.events_alias ENGINE = Alias('db1', 'events');
-- または database.table 形式を使用する
CREATE TABLE db2.events_alias2 ENGINE = Alias('db1.events');
-- どちらの別名も同じように機能する
INSERT INTO db2.events_alias VALUES (now(), 'click', 100);
SELECT * FROM db2.events_alias2;
CREATE TABLE metrics (
ts DateTime,
metric_name String,
value Float64
) ENGINE = MergeTree
ORDER BY ts;
CREATE TABLE metrics_alias ENGINE = Alias('metrics');
-- エイリアス経由で挿入
INSERT INTO metrics_alias VALUES
(now(), 'cpu_usage', 45.2),
(now(), 'memory_usage', 78.5);
-- SELECTを使用して挿入
INSERT INTO metrics_alias
SELECT now(), 'disk_usage', number * 10
FROM system.numbers
LIMIT 5;
-- ターゲットテーブルにデータが存在することを確認
SELECT count() FROM metrics; -- 7を返す
SELECT count() FROM metrics_alias; -- 7を返す
CREATE TABLE users (
id UInt32,
name String
) ENGINE = MergeTree
ORDER BY id;
CREATE TABLE users_alias ENGINE = Alias('users');
-- エイリアス経由でカラムを追加
ALTER TABLE users_alias ADD COLUMN email String DEFAULT '';
-- カラムがターゲットテーブルに追加される
DESCRIBE users;
┌─name──┬─type───┬─default_type─┬─default_expression─┐
│ id │ UInt32 │ │ │
│ name │ String │ │ │
│ email │ String │ DEFAULT │ '' │
└───────┴────────┴──────────────┴────────────────────┘
CREATE TABLE products (
id UInt32,
name String,
price Float64,
status String DEFAULT 'active'
) ENGINE = MergeTree
ORDER BY id;
CREATE TABLE products_alias ENGINE = Alias('products');
INSERT INTO products_alias VALUES
(1, 'item_one', 100.0, 'active'),
(2, 'item_two', 200.0, 'active'),
(3, 'item_three', 300.0, 'inactive');
-- エイリアス経由で更新
ALTER TABLE products_alias UPDATE price = price * 1.1 WHERE status = 'active';
-- エイリアス経由で削除
ALTER TABLE products_alias DELETE WHERE status = 'inactive';
-- 変更はターゲットテーブルに反映される
SELECT * FROM products ORDER BY id;
┌─id─┬─name─────┬─price─┬─status─┐
│ 1 │ item_one │ 110.0 │ active │
│ 2 │ item_two │ 220.0 │ active │
└────┴──────────┴───────┴────────┘
CREATE TABLE logs (
date Date,
level String,
message String
) ENGINE = MergeTree
PARTITION BY toYYYYMM(date)
ORDER BY date;
CREATE TABLE logs_alias ENGINE = Alias('logs');
INSERT INTO logs_alias VALUES
('2024-01-15', 'INFO', 'message1'),
('2024-02-15', 'ERROR', 'message2'),
('2024-03-15', 'INFO', 'message3');
-- エイリアス経由でパーティションをデタッチする
ALTER TABLE logs_alias DETACH PARTITION '202402';
SELECT count() FROM logs_alias; -- 2を返す（パーティション202402はデタッチ済み）
-- パーティションを再度アタッチする
ALTER TABLE logs_alias ATTACH PARTITION '202402';
SELECT count() FROM logs_alias; -- 3を返す
CREATE TABLE events (
id UInt32,
data String
) ENGINE = MergeTree
ORDER BY id;
CREATE TABLE events_alias ENGINE = Alias('events');
-- 複数のインサートにより複数のパーツが作成される
INSERT INTO events_alias VALUES (1, 'data1');
INSERT INTO events_alias VALUES (2, 'data2');
INSERT INTO events_alias VALUES (3, 'data3');
-- パーツ数を確認する
SELECT count() FROM system.parts
WHERE database = currentDatabase()
AND table = 'events'
AND active;
-- エイリアス経由で最適化する
OPTIMIZE TABLE events_alias FINAL;
-- ターゲットテーブルでパーツがマージされる
SELECT count() FROM system.parts
WHERE database = currentDatabase()
AND table = 'events'
AND active; -- 1 を返す
CREATE TABLE important_data (
id UInt32,
value String
) ENGINE = MergeTree
ORDER BY id;
INSERT INTO important_data VALUES (1, 'critical'), (2, 'important');
CREATE TABLE old_alias ENGINE = Alias('important_data');
-- エイリアスの名前変更（ターゲットテーブルは変更なし）
RENAME TABLE old_alias TO new_alias;
-- 同じテーブルに別のエイリアスを作成
CREATE TABLE another_alias ENGINE = Alias('important_data');
-- 1つのエイリアスを削除（ターゲットテーブルおよび他のエイリアスは変更なし）
DROP TABLE new_alias;
SELECT * FROM another_alias; -- 引き続き動作する
SELECT count() FROM important_data; -- データは保持されたまま、2を返す
