Comment créer une table partitionnée hybride LIST DEFAULT HASH - PolarDB

Cette rubrique explique comment créer et modifier une table partitionnée LIST DEFAULT HASH.

Informations générales

PolarDB prend en charge une stratégie de partitionnement hybride combinant les partitionnements LIST et HASH au même niveau. Dans ce modèle, le système évalue d'abord les données par rapport à un ensemble de partitions LIST. Les données ne correspondant à aucune valeur LIST définie sont placées dans une partition par défaut. Si cette partition par défaut est subdivisée, une fonction HASH répartit les données entre les subdivisions. Cette approche est idéale lorsque les valeurs LIST sont distribuées de manière inégale ou lorsqu'il est impossible d'énumérer toutes les valeurs possibles. LIST DEFAULT HASH

Limites

Votre cluster doit répondre à l'une des exigences de version suivantes. Pour vérifier la version de votre cluster, consultez Afficher la version d'un cluster.
- PolarDB for MySQL 8.0.1 avec la version de révision 8.0.1.1.34 ou ultérieure.
- PolarDB for MySQL 8.0.2 avec la version de révision 8.0.2.2.1 ou ultérieure.
Une ou plusieurs partitions par défaut sont prises en charge au niveau de la partition.
Vous pouvez combiner LIST et DEFAULT pour les sous-partitions, mais chaque partition n'admet qu'une seule sous-partition par défaut.
Si une partition ne comporte qu'une seule partition par défaut, tous les types de sous-partitions sont pris en charge.
Si une partition comporte plusieurs partitions par défaut, seules les sous-partitions HASH ou KEY sont prises en charge.

Créer une table partitionnée LIST DEFAULT HASH

Syntaxe

PolarDB permet de créer des tables partitionnées qui stockent, dans une partition par défaut, les données ne correspondant pas à une partition LIST spécifiée. Si cette partition devient trop volumineuse, utilisez la méthode HASH pour la diviser en plusieurs partitions.

CREATE TABLE [ schema. ]table_name
 table_definition
   PARTITION BY LIST [COLUMNS] (expr)
   SUBPARTITION BY ...
   (list_partition_definition[, ..., list_partition_definition],
    default_partition_definition
   )

La syntaxe de default_partition_definition est la suivante :

PARTITION partition_name DEFAULT [PARTITIONS number]

Chaque définition de partition peut également inclure des sous-partitions. LIST DEFAULT est aussi pris en charge pour les sous-partitions et se définit comme suit :

SUBPARTITION subpartition_name DEFAULT

Parameter Description

Paramètre	Description
table_name	Nom de la table à créer.
partition_name	S'il n'existe qu'une seule partition par défaut, ce paramètre indique le nom de la partition. Ce nom doit être unique au sein de la table. S'il existe plusieurs partitions par défaut, ce paramètre indique le préfixe de nom des partitions. Le nom final de la partition est formé en ajoutant un numéro de séquence à ce préfixe.
subpartition_name	Nom de la sous-partition. Ce nom doit être unique au sein de la table. Chaque partition peut comporter au maximum une sous-partition par défaut.
number	Indique le nombre de partitions à créer à partir de la partition par défaut à l'aide d'une méthode HASH. La clause `PARTITIONS number` est facultative. Si cette clause est omise, une seule partition par défaut est créée.

Example

L'exemple suivant montre comment créer une seule partition par défaut :

CREATE TABLE list_default (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT);

L'exemple suivant illustre la création de plusieurs partitions par défaut :

CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

L'exemple ci-dessous montre comment utiliser LIST COLUMNS lorsque la clé de partition est de type VARCHAR :

CREATE TABLE t_goods
(
  country   VARCHAR(30),
  year      VARCHAR(60),
  goods     TEXT
) PARTITION BY LIST COLUMNS(country)
(
  PARTITION p1 VALUES IN ('China'),
  PARTITION p2 VALUES IN ('USA'),
  PARTITION p3 VALUES IN ('Asia'),
  PARTITION p4 VALUES IN ('Singapore'),
  PARTITION p_deft DEFAULT PARTITIONS 5
);

Utilisez l'instruction EXPLAIN pour afficher les partitions :

EXPLAIN SELECT * FROM list_default_hash;

Le résultat est le suivant :

+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
| id | select_type | table             | partitions        | type | possible_keys | key  | key_len | ref  | rows | filtered | Extra |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
|  1 | SIMPLE      | list_default_hash | p0,p1,pd0,pd1,pd2 | ALL  | NULL          | NULL | NULL    | NULL |    1 |   100.00 | NULL  |
+----+-------------+-------------------+-------------------+------+---------------+------+---------+------+------+----------+-------+
1 row in set (0.04 sec)

L'exemple suivant montre comment utiliser LIST DEFAULT pour les sous-partitions :

CREATE TABLE test (a int, b int)
PARTITION BY RANGE(a)
SUBPARTITION BY LIST(b) (
PARTITION part0 VALUES LESS THAN (10)
( SUBPARTITION sub0 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub1 DEFAULT),
PARTITION part1 VALUES LESS THAN (20)
( SUBPARTITION sub2 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub3 DEFAULT),
PARTITION part2 VALUES LESS THAN (30)
( SUBPARTITION sub4 VALUES IN (1,2,3,4,5),
  SUBPARTITION sub5 DEFAULT));

Si une partition comporte plusieurs partitions par défaut, seules les sous-partitions HASH ou KEY sont prises en charge :

CREATE TABLE list_default_hash_sub (
  a INT,
  b INT
)
PARTITION BY LIST (a)
SUBPARTITION BY HASH (b) SUBPARTITIONS 20
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

Modifier une table partitionnée LIST DEFAULT HASH

Les partitions LIST DEFAULT HASH prennent en charge des opérations telles que ALTER TABLE ADD PARTITION, ALTER TABLE DROP PARTITION, ALTER TABLE REORGANIZE PARTITION, ALTER TABLE TRUNCATE PARTITION, ALTER TABLE EXCHANGE PARTITION, ALTER TABLE OPTIMIZE PARTITION, ALTER TABLE REBUILD PARTITION, ALTER TABLE REPAIR PARTITION, ALTER TABLE ANALYZE PARTITION et ALTER TABLE CHECK PARTITION.

Cette rubrique décrit l'utilisation de ALTER TABLE ADD PARTITION, ALTER TABLE DROP PARTITION et ALTER TABLE REORGANIZE PARTITION. Pour plus d'informations sur les autres opérations de modification des tables partitionnées LIST DEFAULT HASH, consultez Modifier une table partitionnée.

ALTER TABLE ADD PARTITION

ADD DEFAULT PARTITION

Syntaxe

Pour une table partitionnée LIST standard sans partition par défaut, utilisez l'instruction ADD PARTITION afin d'ajouter une partition par défaut. Cela convertit la table en une table partitionnée LIST DEFAULT HASH.

ALTER TABLE table_name ADD PARTITION(default_partition_definition)

Example

L'exemple suivant montre comment ajouter une seule partition par défaut :

CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT);

L'exemple ci-dessous illustre l'ajout de deux partitions par défaut :

CREATE TABLE list_tab (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10)
);
ALTER TABLE list_tab ADD PARTITION(PARTITION pd DEFAULT PARTITIONS 2);

ADD LIST PARTITION

Pour PolarDB for MySQL 8.0.2.2.11 et versions ultérieures, vous pouvez utiliser l'option WITHOUT VALIDATION avec l'instruction ALTER TABLE ADD PARTITION afin d'ajouter une partition LIST à une table partitionnée LIST DEFAULT HASH.

Assurez-vous que les valeurs de la nouvelle partition LIST n'existent pas déjà dans la partition par défaut. Le cas échéant, utilisez l'instruction ALTER TABLE REORGANIZE PARTITION pour déplacer les données de la partition par défaut vers une nouvelle partition LIST.

Syntaxe
```
ALTER TABLE table_name ADD PARTITION(
  list_partition_definition[, ..., list_partition_definition])
WITHOUT VALIDATION
```
Example

Ajoutez une nouvelle partition LIST.
```
CREATE TABLE list_default_hash (
  a INT,
  b INT
)
PARTITION BY LIST (a)
(PARTITION p0 VALUES IN (1,2,3,4,5),
 PARTITION p1 VALUES IN (6,7,8,9,10),
 PARTITION pd DEFAULT PARTITIONS 3);

ALTER TABLE list_default_hash ADD PARTITION(
  PARTITION p2 VALUES IN (11,12,13)
)WITHOUT VALIDATION;
```
Après exécution, une partition LIST p2 est ajoutée à la table list_default_hash, et p2 ne contient aucune donnée.

Remarque
Assurez-vous que la partition par défaut ne contient pas les valeurs 11, 12 et 13 pour la colonne a. Sinon, après l'ajout de la nouvelle partition LIST, ces lignes pourraient devenir inaccessibles.

ALTER TABLE DROP PARTITION

Pour plus d'informations sur la syntaxe de DROP PARTITION, consultez DROP PARTITION.

Example

Lorsque vous utilisez l'opération DROP PARTITION, vous devez supprimer toutes les partitions par défaut simultanément. Il est impossible de supprimer uniquement un sous-ensemble de partitions par défaut.

Exécutez la commande DROP PARTITION pour supprimer toutes les partitions.

ALTER TABLE list_default_hash DROP PARTITION pd0,pd1,pd2;
Query OK, 0 rows affected (0.33 sec)
Records: 0  Duplicates: 0  Warnings: 0

Message d'erreur

Une erreur se produit si vous tentez de supprimer seulement certaines partitions par défaut.

ALTER TABLE list_default_hash DROP PARTITION pd0;

La commande renvoie le message d'erreur suivant :

ERROR 8078 (HY000): DROP PARTITION cannot be used on default partitions of LIST DEFAULT, except once dropping all default partitions

ALTER TABLE REORGANIZE PARTITION

Pour plus d'informations sur la syntaxe de REORGANIZE PARTITION, consultez REORGANIZE PARTITION.

Example

Lorsque vous utilisez l'opération REORGANIZE PARTITION, vous devez modifier toutes les partitions par défaut simultanément. Il est impossible de modifier uniquement un sous-ensemble de partitions par défaut.

Utilisez REORGANIZE PARTITION pour changer le nombre de partitions par défaut :
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO(
  PARTITION pd DEFAULT PARTITIONS 3);
```
Après exécution de cette instruction, le nombre de partitions par défaut passe de deux à trois.
Utilisez REORGANIZE PARTITION pour extraire une nouvelle partition LIST des partitions par défaut :
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  pd0,pd1
INTO (
 PARTITION p2 VALUES IN (20,21),
 PARTITION pd DEFAULT PARTITIONS 2);
```
Cette instruction ajoute une nouvelle partition LIST nommée p2 à la table et déplace les lignes correspondant à VALUES IN (20,21) depuis les partitions par défaut vers p2.
Utilisez REORGANIZE PARTITION pour fusionner une partition LIST dans les partitions par défaut :
```
ALTER TABLE list_default_hash
REORGANIZE PARTITION
  p2, pd0, pd1
INTO (
 PARTITION pd DEFAULT PARTITIONS 2);
```
Cette instruction fusionne la partition LIST p2 dans les partitions par défaut.
Utilisez REORGANIZE PARTITION pour étendre une partition LIST en déplaçant des valeurs depuis les partitions par défaut :
```
ALTER TABLE list_default_hash
REORGANIZE partition
  p2, pd0, pd1
INTO (
  PARTITION p2 VALUES IN (20,21,22,23,24),
  PARTITION pd DEFAULT PARTITIONS 4);
```
Cette instruction modifie la définition de p2, passant de PARTITION p2 VALUES IN (20,21) à PARTITION p2 VALUES IN (20,21,22,23,24). Elle déplace également les données correspondantes des partitions par défaut vers p2.

Rubriques connexes

Quand choisir le partitionnement LIST DEFAULT HASH