> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Движок таблицы Alias создаёт прозрачный прокси к другой таблице. Все операции направляются в целевую таблицу, а сам псевдоним данных не хранит.

# Движок таблицы Alias

Движок `Alias` создаёт прокси для другой таблицы. Все операции чтения и записи перенаправляются в целевую таблицу, при этом сам псевдоним не хранит данные и лишь поддерживает ссылку на целевую таблицу.

<div id="creating-a-table">
  ## Создание таблицы
</div>

```sql theme={null}
CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_table)
```

Или с явным именем базы данных:

```sql theme={null}
CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_db, target_table)
```

<Note>
  Таблица `Alias` не поддерживает явное описание столбцов. Столбцы автоматически наследуются от целевой таблицы. Благодаря этому таблица-псевдоним всегда соответствует схеме целевой таблицы.
</Note>

<div id="engine-parameters">
  ## Параметры движка
</div>

* **`target_db (optional)`** — Имя базы данных, содержащей целевую таблицу.
* **`target_table`** — Имя целевой таблицы.

<Note>
  Если `target_db` не указан, а `target_table` задан не полным именем (например, `Alias('my_table')`), цель определяется в той же базе данных, что и сам псевдоним, а не в текущей базе данных сеанса.
</Note>

<div id="supported-operations">
  ## Поддерживаемые операции
</div>

Движок таблицы `Alias` поддерживает все основные операции.

<div id="operations-on-target">
  ### Операции с целевой таблицей
</div>

Эти операции перенаправляются в целевую таблицу:

| Операция                     | Поддержка | Описание                                                     |
| ---------------------------- | --------- | ------------------------------------------------------------ |
| `SELECT`                     | ✅         | Чтение данных из целевой таблицы                             |
| `INSERT`                     | ✅         | Запись данных в целевую таблицу                              |
| `INSERT SELECT`              | ✅         | Батчевая вставка в целевую таблицу                           |
| `ALTER TABLE ADD COLUMN`     | ✅         | Добавление столбцов в целевую таблицу                        |
| `ALTER TABLE MODIFY SETTING` | ✅         | Изменение настроек целевой таблицы                           |
| `ALTER TABLE PARTITION`      | ✅         | Операции с партициями (DETACH/ATTACH/DROP) в целевой таблице |
| `ALTER TABLE UPDATE`         | ✅         | Обновление строк в целевой таблице (мутация)                 |
| `ALTER TABLE DELETE`         | ✅         | Удаление строк из целевой таблицы (мутация)                  |
| `OPTIMIZE TABLE`             | ✅         | Оптимизация целевой таблицы (слияние частей)                 |
| `TRUNCATE TABLE`             | ✅         | Очистка целевой таблицы                                      |

<div id="operations-on-alias">
  ### Операции с самим псевдонимом
</div>

Эти операции затрагивают только псевдоним, **а не** целевую таблицу:

| Операция       | Поддержка | Описание                                                          |
| -------------- | --------- | ----------------------------------------------------------------- |
| `DROP TABLE`   | ✅         | Удаляется только псевдоним; целевая таблица не изменяется         |
| `RENAME TABLE` | ✅         | Переименовывается только псевдоним; целевая таблица не изменяется |

<div id="usage-examples">
  ## Примеры использования
</div>

<div id="basic-alias-creation">
  ### Создание простого псевдонима
</div>

Создайте простой псевдоним в той же базе данных:

```sql theme={null}
-- Создать исходную таблицу
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;
```

```text theme={null}
┌─id─┬─name─┬─value─┐
│  1 │ one  │  10.1 │
│  2 │ two  │  20.2 │
└────┴──────┴───────┘
```

<div id="cross-database-alias">
  ### Межбазовый псевдоним
</div>

Создайте псевдоним, указывающий на таблицу в другой базе данных:

```sql theme={null}
-- Создать базы данных
CREATE DATABASE db1;
CREATE DATABASE db2;

-- Создать исходную таблицу в db1
CREATE TABLE db1.events (
    timestamp DateTime,
    event_type String,
    user_id UInt32
) ENGINE = MergeTree
ORDER BY timestamp;

-- Создать псевдоним в db2, указывающий на db1.events
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;
```

<div id="write-operations">
  ### Операции записи через псевдоним
</div>

Все операции записи направляются в целевую таблицу:

```sql theme={null}
CREATE TABLE metrics (
    ts DateTime,
    metric_name String,
    value Float64
) ENGINE = MergeTree
ORDER BY ts;

CREATE TABLE metrics_alias ENGINE = Alias('metrics');

-- Insert through alias
INSERT INTO metrics_alias VALUES
    (now(), 'cpu_usage', 45.2),
    (now(), 'memory_usage', 78.5);

-- Insert with SELECT
INSERT INTO metrics_alias
SELECT now(), 'disk_usage', number * 10
FROM system.numbers
LIMIT 5;

-- Verify data is in the target table
SELECT count() FROM metrics;  -- Returns 7
SELECT count() FROM metrics_alias;  -- Returns 7
```

<div id="schema-modification">
  ### Изменение схемы
</div>

Операции `ALTER` изменяют схему целевой таблицы:

```sql theme={null}
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;
```

```text theme={null}
┌─name──┬─type───┬─default_type─┬─default_expression─┐
│ id    │ UInt32 │              │                    │
│ name  │ String │              │                    │
│ email │ String │ DEFAULT      │ ''                 │
└───────┴────────┴──────────────┴────────────────────┘
```

<div id="data-mutations">
  ### Мутации данных
</div>

Поддерживаются операции UPDATE и DELETE:

```sql theme={null}
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');

-- Update through alias
ALTER TABLE products_alias UPDATE price = price * 1.1 WHERE status = 'active';

-- Delete through alias
ALTER TABLE products_alias DELETE WHERE status = 'inactive';

-- Changes are applied to target table
SELECT * FROM products ORDER BY id;
```

```text theme={null}
┌─id─┬─name─────┬─price─┬─status─┐
│  1 │ item_one │ 110.0 │ active │
│  2 │ item_two │ 220.0 │ active │
└────┴──────────┴───────┴────────┘
```

<div id="partition-operations">
  ### Операции с партициями
</div>

Для партиционированных таблиц операции над партициями перенаправляются:

```sql theme={null}
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');

-- Detach partition through alias
ALTER TABLE logs_alias DETACH PARTITION '202402';

SELECT count() FROM logs_alias;  -- Returns 2 (partition 202402 detached)

-- Attach partition back
ALTER TABLE logs_alias ATTACH PARTITION '202402';

SELECT count() FROM logs_alias;  -- Returns 3
```

<div id="table-optimization">
  ### Оптимизация таблицы
</div>

Операции оптимизации выполняют слияние частей в целевой таблице:

```sql theme={null}
CREATE TABLE events (
    id UInt32,
    data String
) ENGINE = MergeTree
ORDER BY id;

CREATE TABLE events_alias ENGINE = Alias('events');

-- Multiple inserts create multiple parts
INSERT INTO events_alias VALUES (1, 'data1');
INSERT INTO events_alias VALUES (2, 'data2');
INSERT INTO events_alias VALUES (3, 'data3');

-- Check parts count
SELECT count() FROM system.parts
WHERE database = currentDatabase()
AND table = 'events'
AND active;

-- Optimize through alias
OPTIMIZE TABLE events_alias FINAL;

-- Parts are merged in target table
SELECT count() FROM system.parts
WHERE database = currentDatabase()
AND table = 'events'
AND active;  -- Returns 1
```

<div id="alias-management">
  ### Управление псевдонимами
</div>

Псевдонимы можно независимо переименовывать и удалять:

```sql theme={null}
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 alias (target table unchanged)
RENAME TABLE old_alias TO new_alias;

-- Create another alias to same table
CREATE TABLE another_alias ENGINE = Alias('important_data');

-- Drop one alias (target table and other aliases unchanged)
DROP TABLE new_alias;

SELECT * FROM another_alias;  -- Still works
SELECT count() FROM important_data;  -- Data intact, returns 2
```