Motor de tabela Alias - ClickHouse Documentation

O motor Alias cria um proxy para outra tabela. Todas as operações de leitura e gravação são encaminhadas para a tabela de destino, enquanto o próprio alias não armazena dados e apenas mantém uma referência à tabela de destino.

Este é um recurso experimental que pode mudar de forma incompatível com versões anteriores em lançamentos futuros. Habilite o uso do motor de tabela Alias com a configuração allow_experimental_alias_table_engine. Execute o comando set allow_experimental_alias_table_engine = 1.

Criando uma tabela

CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_table)

Ou com o nome do banco de dados explícito:

CREATE TABLE [db_name.]alias_name
ENGINE = Alias(target_db, target_table)

A tabela Alias não oferece suporte à definição explícita de colunas. As colunas são herdadas automaticamente da tabela de destino. Isso garante que o alias sempre corresponda ao esquema da tabela de destino.

Parâmetros do motor

target_db (optional) — Nome do banco de dados que contém a tabela de destino.
target_table — Nome da tabela de destino.

Quando target_db é omitido e target_table não é totalmente qualificado (por exemplo, Alias('my_table')), o destino é resolvido para o mesmo banco de dados do próprio alias, e não para o banco de dados atual da sessão.

Operações suportadas

O motor de tabela Alias oferece suporte às principais operações.

Operações na tabela de destino

Estas operações são encaminhadas por proxy para a tabela de destino:

Operação	Suporte	Descrição
`SELECT`	✅	Ler dados da tabela de destino
`INSERT`	✅	Gravar dados na tabela de destino
`INSERT SELECT`	✅	Inserção em lote na tabela de destino
`ALTER TABLE ADD COLUMN`	✅	Adicionar colunas à tabela de destino
`ALTER TABLE MODIFY SETTING`	✅	Modificar as configurações da tabela de destino
`ALTER TABLE PARTITION`	✅	Operações de partição (DETACH/ATTACH/DROP) no destino
`ALTER TABLE UPDATE`	✅	Atualizar linhas na tabela de destino (mutação)
`ALTER TABLE DELETE`	✅	Excluir linhas da tabela de destino (mutação)
`OPTIMIZE TABLE`	✅	Otimizar a tabela de destino (mesclagem de partes)
`TRUNCATE TABLE`	✅	Truncar a tabela de destino

Operações sobre o próprio alias

Estas operações afetam apenas o alias, não a tabela de destino:

Operação	Suporte	Descrição
`DROP TABLE`	✅	Remove apenas o alias; a tabela de destino permanece inalterada
`RENAME TABLE`	✅	Renomeia apenas o alias; a tabela de destino permanece inalterada

Exemplos de uso

Criação de alias simples

Crie um alias simples no mesmo banco de dados:

-- Criar tabela de origem
CREATE TABLE source_data (
    id UInt32,
    name String,
    value Float64
) ENGINE = MergeTree
ORDER BY id;

-- Inserir alguns dados
INSERT INTO source_data VALUES (1, 'one', 10.1), (2, 'two', 20.2);

-- Criar alias
CREATE TABLE data_alias ENGINE = Alias('source_data');

-- Consultar via alias
SELECT * FROM data_alias;

┌─id─┬─name─┬─value─┐
│  1 │ one  │  10.1 │
│  2 │ two  │  20.2 │
└────┴──────┴───────┘

Alias entre bancos de dados

Crie um alias que aponte para uma tabela em outro banco de dados:

-- Criar bancos de dados
CREATE DATABASE db1;
CREATE DATABASE db2;

-- Criar tabela de origem em db1
CREATE TABLE db1.events (
    timestamp DateTime,
    event_type String,
    user_id UInt32
) ENGINE = MergeTree
ORDER BY timestamp;

-- Criar alias em db2 apontando para db1.events
CREATE TABLE db2.events_alias ENGINE = Alias('db1', 'events');

-- Ou usando o formato database.table
CREATE TABLE db2.events_alias2 ENGINE = Alias('db1.events');

-- Ambos os aliases funcionam de forma idêntica
INSERT INTO db2.events_alias VALUES (now(), 'click', 100);
SELECT * FROM db2.events_alias2;

Operações de gravação via alias

Todas as operações de gravação são encaminhadas para a tabela de destino:

CREATE TABLE metrics (
    ts DateTime,
    metric_name String,
    value Float64
) ENGINE = MergeTree
ORDER BY ts;

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

-- Inserir através do alias
INSERT INTO metrics_alias VALUES 
    (now(), 'cpu_usage', 45.2),
    (now(), 'memory_usage', 78.5);

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

-- Verificar se os dados estão na tabela de destino
SELECT count() FROM metrics;  -- Retorna 7
SELECT count() FROM metrics_alias;  -- Retorna 7

Modificação do esquema

As operações ALTER modificam o esquema da tabela de destino:

CREATE TABLE users (
    id UInt32,
    name String
) ENGINE = MergeTree
ORDER BY id;

CREATE TABLE users_alias ENGINE = Alias('users');

-- Adicionar coluna através do alias
ALTER TABLE users_alias ADD COLUMN email String DEFAULT '';

-- Coluna é adicionada à tabela de destino
DESCRIBE users;

┌─name──┬─type───┬─default_type─┬─default_expression─┐
│ id    │ UInt32 │              │                    │
│ name  │ String │              │                    │
│ email │ String │ DEFAULT      │ ''                 │
└───────┴────────┴──────────────┴────────────────────┘

Mutações de dados

As operações UPDATE e DELETE são suportadas:

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');

-- Atualizar através do alias
ALTER TABLE products_alias UPDATE price = price * 1.1 WHERE status = 'active';

-- Excluir através do alias
ALTER TABLE products_alias DELETE WHERE status = 'inactive';

-- As alterações são aplicadas à tabela de destino
SELECT * FROM products ORDER BY id;

┌─id─┬─name─────┬─price─┬─status─┐
│  1 │ item_one │ 110.0 │ active │
│  2 │ item_two │ 220.0 │ active │
└────┴──────────┴───────┴────────┘

Operações de partição

Para tabelas particionadas, as operações de partição são repassadas:

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');

-- Desanexar partição através do alias
ALTER TABLE logs_alias DETACH PARTITION '202402';

SELECT count() FROM logs_alias;  -- Retorna 2 (partição 202402 desanexada)

-- Reanexar partição
ALTER TABLE logs_alias ATTACH PARTITION '202402';

SELECT count() FROM logs_alias;  -- Retorna 3

Otimização da tabela

As operações OPTIMIZE mesclam partes na tabela de destino:

CREATE TABLE events (
    id UInt32,
    data String
) ENGINE = MergeTree
ORDER BY id;

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

-- Múltiplos inserts criam múltiplas partes
INSERT INTO events_alias VALUES (1, 'data1');
INSERT INTO events_alias VALUES (2, 'data2');
INSERT INTO events_alias VALUES (3, 'data3');

-- Verificar contagem de partes
SELECT count() FROM system.parts 
WHERE database = currentDatabase() 
  AND table = 'events' 
  AND active;

-- Otimizar através do alias
OPTIMIZE TABLE events_alias FINAL;

-- As partes são mescladas na tabela de destino
SELECT count() FROM system.parts 
WHERE database = currentDatabase() 
  AND table = 'events' 
  AND active;  -- Retorna 1

Gerenciamento de aliases

Os aliases podem ser renomeados ou excluídos independentemente:

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');

-- Renomear alias (tabela de destino inalterada)
RENAME TABLE old_alias TO new_alias;

-- Criar outro alias para a mesma tabela
CREATE TABLE another_alias ENGINE = Alias('important_data');

-- Remover um alias (tabela de destino e outros aliases inalterados)
DROP TABLE new_alias;

SELECT * FROM another_alias;  -- Ainda funciona
SELECT count() FROM important_data;  -- Dados intactos, retorna 2

​Criando uma tabela

​Parâmetros do motor

​Operações suportadas

​Operações na tabela de destino

​Operações sobre o próprio alias

​Exemplos de uso

​Criação de alias simples

​Alias entre bancos de dados

​Operações de gravação via alias

​Modificação do esquema

​Mutações de dados

​Operações de partição

​Otimização da tabela

​Gerenciamento de aliases

Criando uma tabela

Parâmetros do motor

Operações suportadas

Operações na tabela de destino

Operações sobre o próprio alias

Exemplos de uso

Criação de alias simples

Alias entre bancos de dados

Operações de gravação via alias

Modificação do esquema

Mutações de dados

Operações de partição

Otimização da tabela

Gerenciamento de aliases