PolarDB:Crie e use um CCI

CREATE
    CLUSTERED COLUMNAR INDEX index_name
    ON tbl_name (index_sort_key_name,...)
    [partition_options]

-- Define a partitioning policy
partition_options:
    PARTITION BY
          HASH({column_name | partition_func(column_name)})
        | KEY(column_list)
        | RANGE({column_name | partition_func(column_name)})
        | RANGE COLUMNS(column_list)
        | LIST({column_name | partition_func(column_name)})
        | LIST COLUMNS(column_list)
    partition_list_spec

-- Define a partitioning function
partition_func:
    YEAR
  | TO_DAYS
  | TO_SECOND
  | UNIX_TIMESTAMP
  | MONTH

-- Define a partition list
partition_list_spec:
    hash_partition_list
  | range_partition_list
  | list_partition_list

-- For HASH/KEY partitioned tables
hash_partition_list:
    PARTITIONS partition_count

-- For RANGE/RANGE COLUMNS partitioned tables
range_partition_list:
    range_partition [, range_partition ...]

range_partition:
    PARTITION partition_name VALUES LESS THAN {(expr | value_list)} [partition_spec_options]

-- For LIST/LIST COLUMNS partitioned tables
list_partition_list:
    list_partition [, list_partition ...]

list_partition:
    PARTITION partition_name VALUES IN (value_list) [partition_spec_options]

CREATE TABLE t_order (
  `id` bigint(11) NOT NULL AUTO_INCREMENT,
  `order_id` varchar(20) DEFAULT NULL,
  `buyer_id` varchar(20) DEFAULT NULL,
  `seller_id` varchar(20) DEFAULT NULL,
  `order_snapshot` longtext DEFAULT NULL,
  `order_detail` longtext DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `l_i_order` (`order_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 partition by hash(`order_id`) partitions 16;

CREATE CLUSTERED COLUMNAR INDEX `cc_i_seller` ON t_order (`seller_id`) partition by hash(`order_id`) partitions 16;

Verifique o status de criação do CCI

Após executar a instrução CREATE CLUSTERED COLUMNAR INDEX, verifique o status da compilação:

SHOW COLUMNAR INDEX FROM t_order;

Para monitorar o progresso da tarefa DDL:

SHOW DDL;

O CCI estará pronto para uso quando o status for exibido como concluído. Para obter uma descrição dos campos de saída, consulte SHOW COLUMNAR INDEX e SHOW DDL.

Seleção automática

Em consultas a uma tabela primária que contém um CCI, o PolarDB-X seleciona automaticamente a tabela de índice que o otimizador determina ter o menor custo. Atualmente, apenas instâncias columnstore somente leitura suportam consultas baseadas em CCI. Nenhuma configuração adicional é necessária.

USE INDEX

Sugira ao otimizador o uso do índice especificado:

USE INDEX({index_name},...)

Exemplo — preferir cc_i_seller:

SELECT t_order.id, t_order.order_snapshot
FROM t_order USE INDEX(cc_i_seller)
WHERE t_order.seller_id = 's1';

IGNORE INDEX

Indique ao otimizador para ignorar o índice especificado:

IGNORE INDEX({index_name},...)

Exemplo — excluir cc_i_seller da consideração:

SELECT t_order.id, t_order.order_snapshot
FROM t_order IGNORE INDEX(cc_i_seller)
WHERE t_order.seller_id = 's1';

FORCE INDEX

Sobrescreva o otimizador e force o uso do índice especificado:

FORCE INDEX({index_name})

Exemplo — forçar cc_i_seller em uma junção:

SELECT a.*, b.order_id
FROM t_seller a
  JOIN t_order b FORCE INDEX(cc_i_seller) ON a.seller_id = b.seller_id
WHERE a.seller_nick = 'abc';

Tipos de dados suportados

A tabela a seguir mostra os tipos de dados suportados para a chave primária da tabela primária e para as chaves de ordenação e de partição do CCI:

Os algoritmos de particionamento suportam diferentes tipos de dados. Para mais informações, consulte Tipos de dados .

Limites de instruções DDL

Para controlar se instruções DDL podem ser executadas em uma tabela que possui um CCI, defina o seguinte parâmetro (true permite DDL; false bloqueia):

SET [GLOBAL] forbid_ddl_with_cci = [true | false];

Operações DDL suportadas em tabelas primárias com CCI:

Restrições de alteração de coluna com ALTER TABLE:

Nas versões 5.4.20-20250714 e posteriores, MODIFY COLUMN e alterações no valor padrão de colunas são suportadas para algumas chaves primárias, chaves de partição de CCI e chaves de ordenação de CCI.

A modificação de uma coluna crítica (chave primária, chave de partição do CCI ou chave de ordenação do CCI) pode acionar uma recompilação completa do CCI, o que pode resultar em uma operação longa em tabelas grandes. Essa funcionalidade está desativada por padrão. Recomendamos o uso de execução assíncrona. Para ativá-la, defina os seguintes parâmetros antes de executar a instrução ALTER:

-- Allow modifying critical columns of a CCI
SET ENABLE_MODIFY_CCI_CRITICAL_COLUMN = TRUE;
-- Rebuild strategy: 0 lets the system select automatically
SET REBUILD_CCI_STRATEGY = 0;
-- Maximum number of CCIs per table; increase if the table already has multiple CCIs
SET MAX_CCI_COUNT = 2;

Tipos de dados suportados para MODIFY COLUMN / CHANGE COLUMN:

Caso precise alterar uma coluna para POINT ou GEOMETRY, exclua o CCI com DROP INDEX, altere o tipo de dado e recrie o CCI.

Alterações de índice suportadas com ALTER TABLE: