PolarDB:Converter uma tabela não particionada em uma tabela particionada por intervalo

Pré-requisitos

Antes de começar, verifique se você possui:

• Um cluster do PolarDB for MySQL 8.0.2 com versão de revisão 8.0.2.2.10 ou posterior

Para verificar sua versão, consulte a seção "Query the engine version" em Engine versions.

Limitações

Não é possível converter tabelas com colunas adicionadas via INSTANT ADD COLUMN em tabelas particionadas por intervalo.

Converter uma tabela não particionada

Ao executar um comando ALTER TABLE PARTITION BY padrão, o MySQL valida cada linha em relação à definição da partição antes de mover os dados, o que torna o processo lento em tabelas grandes. A cláusula WITHOUT VALIDATION ignora essa verificação e move todos os dados diretamente para a primeira partição, tornando a conversão instantânea.

Syntax

ALTER TABLE table_name
PARTITION BY RANGE {(expr) | COLUMNS(column_list)}
(partition_definition [, partition_definition] ...)
WITHOUT VALIDATION;

partition_definition:

PARTITION partition_name
    VALUES LESS THAN {(value | value_list) | MAXVALUE}

Parameters

Example

O exemplo a seguir converte a tabela não particionada t1 em uma tabela particionada por intervalo com duas partições.

CREATE TABLE t1 (
    `a` INT,
    `b` INT,
    PRIMARY KEY (a, b)
);

INSERT INTO t1 VALUES (1,1),(2,1),(3,1),(4,1),(111,111),(3333,333);

ALTER TABLE t1
PARTITION BY RANGE (a) (
    PARTITION p0 VALUES LESS THAN (100),
    PARTITION p1 VALUES LESS THAN (200)
) WITHOUT VALIDATION;

Após a execução do comando, todas as linhas de t1 — incluindo aquelas com a = 111 e a = 3333 — são alocadas em p0 sem validação. Linhas cujos valores excedem o limite superior declarado de p0 (a < 100) permanecem armazenadas fisicamente em p0, mas podem não ser recuperadas por consultas com partition pruning.

Uso com tabelas particionadas por INTERVAL

A cláusula WITHOUT VALIDATION também funciona com tabelas particionadas por INTERVAL. Isso permite carregar uma tabela não particionada existente como a partição inicial, enquanto o PolarDB for MySQL cria automaticamente partições RANGE subsequentes no intervalo especificado.

Example

CREATE TABLE t1 (
    ID   INT,
    DATE DATE,
    PRIMARY KEY (ID, DATE)
);

ALTER TABLE t1
PARTITION BY RANGE COLUMNS (DATE) INTERVAL (DAY, 1) (
    PARTITION p0 VALUES LESS THAN ('2023-01-31')
) WITHOUT VALIDATION;

Todas as linhas existentes em t1 são alocadas em p0. Novas linhas inseridas após a conversão são direcionadas automaticamente para novas partições diárias criadas pela definição de INTERVAL.

Desempenho

Como WITHOUT VALIDATION atualiza apenas os metadados da tabela, o tempo de conversão é constante, independentemente do tamanho da tabela.