Tous les produits
Search
Centre de documentation

AnalyticDB:Définition des tables partitionnées

Dernière mise à jour :Aug 10, 2026

AnalyticDB for PostgreSQL vous permet de diviser une grande table en partitions afin que les requêtes analysent uniquement les partitions correspondant aux conditions de filtrage. Cette approche évite les analyses complètes de la table et améliore les performances des requêtes.

Quand utiliser le partitionnement

Le partitionnement est particulièrement efficace lorsque les trois conditions suivantes sont réunies :

  • La table est volumineuse. Les tables contenant un grand nombre de lignes sont de bonnes candidates au partitionnement.

  • Les performances des requêtes sont insatisfaisantes. Partitionnez uniquement les tables dont les temps de réponse des requêtes dépassent les seuils acceptables.

  • Les prédicats de requête présentent des modèles d'accès clairs. Examinez les clauses WHERE de vos requêtes habituelles. Si les mêmes colonnes apparaissent fréquemment, elles constituent des candidats naturels pour la clé de partitionnement.

Types de partitionnement pris en charge

Type Méthode de division des données Cas d'utilisation typique
Partitionnement par plage Plage numérique, telle qu'une date ou un entier Données de séries temporelles, identifiants séquentiels
Partitionnement par liste Liste explicite de valeurs Données catégorielles, telles que la région ou le statut
Partitionnement multi-niveaux Combinaison de plages et de listes sur plusieurs niveaux Grands ensembles de données avec plusieurs dimensions de filtrage

Choisir une clé de partitionnement

La clé de partitionnement détermine l'efficacité de l'élimination des partitions (partition pruning) :

  • Correspondance avec les prédicats de requête. Choisissez la ou les colonnes qui apparaissent le plus souvent dans les clauses WHERE. L'élimination des partitions n'est efficace que si les conditions de la requête incluent la clé de partitionnement.

  • Alignement avec votre stratégie de rétention des données. Si vous supprimez régulièrement d'anciens lots de données, concevez les partitions de manière à ce que les données à supprimer résident dans une seule partition. La suppression d'une partition est bien plus rapide que l'exécution d'une instruction DELETE.

  • Contrainte de clé primaire. Si la table possède une clé primaire, la clé de partitionnement doit être une colonne de cette clé primaire. En l'absence de clé primaire, toute colonne peut être utilisée.

Créer une table partitionnée par plage

Spécifiez START, END et EVERY pour générer automatiquement des partitions dans une plage. Par défaut, START est inclusif et END est exclusif.

Partitionnement par date :

CREATE TABLE sales (id int, date date, amt decimal(10,2))
DISTRIBUTED BY (id)
PARTITION BY RANGE (date)
( START (date '2016-01-01') INCLUSIVE
   END (date '2017-01-01') EXCLUSIVE
   EVERY (INTERVAL '1 day') );

Partitionnement par entier avec une partition par défaut :

CREATE TABLE rank (id int, rank int, year int, gender char(1), count int)
DISTRIBUTED BY (id)
PARTITION BY RANGE (year)
( START (2006) END (2016) EVERY (1),
  DEFAULT PARTITION extra );
La clause DEFAULT PARTITION capture les lignes qui ne correspondent à aucune des plages définies.

Créer une table partitionnée par liste

La clé de partitionnement peut être n'importe quelle colonne dont le type de données prend en charge la comparaison de valeurs. Déclarez une description de valeur pour chaque partition.

CREATE TABLE rank (id int, rank int, year int, gender
char(1), count int )
DISTRIBUTED BY (id)
PARTITION BY LIST (gender)
( PARTITION girls VALUES ('F'),
  PARTITION boys VALUES ('M'),
  DEFAULT PARTITION other );

Créer une table partitionnée multi-niveaux

L'exemple suivant crée une table partitionnée sur trois niveaux :

  • Niveau 1 : partitionnement par plage selon year

  • Niveau 2 (sous-partition) : partitionnement par plage selon month

  • Niveau 3 (sous-partition) : partitionnement par liste selon region

CREATE TABLE sales (id int, year int, month int, day int,
region text)
DISTRIBUTED BY (id)
PARTITION BY RANGE (year)
    SUBPARTITION BY RANGE (month)
       SUBPARTITION TEMPLATE (
        START (1) END (13) EVERY (1),
        DEFAULT SUBPARTITION other_months )
           SUBPARTITION BY LIST (region)
             SUBPARTITION TEMPLATE (
               SUBPARTITION usa VALUES ('usa'),
               SUBPARTITION europe VALUES ('europe'),
               SUBPARTITION asia VALUES ('asia'),
               DEFAULT SUBPARTITION other_regions )
( START (2002) END (2012) EVERY (1),
  DEFAULT PARTITION outlying_years );

Ajouter une partition

Utilisez ALTER TABLE ... ADD PARTITION pour ajouter une partition à une table partitionnée existante.

Si la table a été créée avec un modèle de sous-partition, la nouvelle partition est automatiquement sous-partitionnée :

ALTER TABLE sales ADD PARTITION
            START (date '2017-02-01') INCLUSIVE
            END (date '2017-03-01') EXCLUSIVE;

Si aucun modèle de sous-partition n'a été utilisé, définissez les sous-partitions inline lors de l'ajout de la partition :

ALTER TABLE sales ADD PARTITION
            START (date '2017-02-01') INCLUSIVE
            END (date '2017-03-01') EXCLUSIVE
      ( SUBPARTITION usa VALUES ('usa'),
        SUBPARTITION asia VALUES ('asia'),
        SUBPARTITION europe VALUES ('europe') );

Pour sous-partitionner une partition existante :

ALTER TABLE sales ALTER PARTITION FOR (RANK(12))
      ADD PARTITION africa VALUES ('africa');
Il est impossible d'ajouter des partitions à une table dotée d'une partition par défaut. Pour ajouter des partitions à une telle table, divisez plutôt la partition par défaut. Consultez la section Diviser une partition .

Spécifier un nom de partition

À partir d'AnalyticDB for PostgreSQL V6.3.10.9, utilisez la clause WITH(tablename=<tablename>) pour attribuer des noms explicites aux partitions lors de la création d'une table :

CREATE TABLE partition_with_name_list (a int, b int, c int) DISTRIBUTED BY (a) PARTITION BY LIST (a)
(
    PARTITION p1 VALUES (1)  WITH (tablename='partition_with_name_list_p1'),
    PARTITION p2 VALUES (2)  WITH (tablename='partition_with_name_list_p2'),
    PARTITION p3 VALUES (3)  WITH (tablename='partition_with_name_list_p3'),
    PARTITION p4 VALUES (4)  WITH (tablename='partition_with_name_list_p4')
);

Renommer une partition

À partir d'AnalyticDB for PostgreSQL V6.3.10.9, renommez une partition avec :

ALTER TABLE partition_with_name_list_p1 RENAME TO partition_with_name_list_p1r;

Diviser une partition

Utilisez ALTER TABLE ... SPLIT PARTITION pour diviser une partition en deux.

Limites :

  • Si des sous-partitions existent, seule la sous-partition de niveau le plus bas peut être divisée.

  • La valeur de division dans la clause AT est attribuée à la seconde partition.

Diviser une partition existante :

L'exemple suivant divise une partition de janvier 2017 au 16 janvier. Les données du 1er au 15 janvier vont dans la première partition ; celles du 16 au 31 janvier vont dans la seconde.

ALTER TABLE sales SPLIT PARTITION FOR ('2017-01-01')
AT ('2017-01-16')
INTO (PARTITION jan171to15, PARTITION jan1716to31);

Diviser la partition par défaut pour ajouter une nouvelle partition :

Lorsqu'une table possède une partition par défaut, divisez-la pour extraire une partition nommée. La partition par défaut doit être la seconde partition dans la clause INTO.

ALTER TABLE sales SPLIT DEFAULT PARTITION
START ('2017-01-01') INCLUSIVE
END ('2017-02-01') EXCLUSIVE
INTO (PARTITION jan17, default partition);

Déterminer la granularité des partitions

La granularité des partitions implique un compromis entre la quantité de données dans chaque partition et le nombre total de partitions. Une granularité plus fine réduit la quantité de données par partition, mais augmente le nombre total de partitions.

En règle générale, maintenez le nombre de partitions à 200 ou moins par table. Un nombre élevé de partitions peut réduire les performances de la base de données : par exemple, l'optimiseur de requêtes met plus de temps à générer les plans d'exécution et les opérations VACUUM prennent plus de temps à se terminer.

Optimiser les requêtes sur les tables partitionnées

AnalyticDB for PostgreSQL prend en charge l'élimination des partitions (partition pruning) : lorsqu'une requête inclut des conditions sur la clé de partitionnement, l'optimiseur analyse uniquement les partitions correspondantes au lieu de la table entière.

Vérifiez que l'élimination est active :

EXPLAIN
  SELECT * FROM sales
  WHERE year = 2008
    AND month = 1
    AND day = 3
    AND region = 'usa';

Sortie attendue (élimination fonctionnant correctement) :

Gather Motion 4:1  (slice1; segments: 4)  (cost=0.00..431.00 rows=1 width=24)
  ->  Sequence  (cost=0.00..431.00 rows=1 width=24)
        ->  Partition Selector for sales (dynamic scan id: 1)  (cost=10.00..100.00 rows=25 width=4)
              Filter: year = 2008 AND month = 1 AND region = 'usa'::text
              Partitions selected:  1 (out of 468)
        ->  Dynamic Table Scan on sales (dynamic scan id: 1)  (cost=0.00..431.00 rows=1 width=24)
              Filter: year = 2008 AND month = 1 AND day = 3 AND region = 'usa'::text

Dans ce plan, Partitions selected: 1 (out of 468) confirme que l'élimination est active. Si vous constatez un nombre élevé de partitions sélectionnées malgré des conditions de filtrage spécifiques, vérifiez si la colonne de filtrage correspond à la clé de partitionnement.

Interroger les définitions de partition

Interrogez toutes les partitions d'une table à partir de la vue système pg_partitions :

SELECT
  partitionboundary,
  partitiontablename,
  partitionname,
  partitionlevel,
  partitionrank
FROM pg_partitions
WHERE tablename='sales';

Opérations connexes

Pour obtenir la liste complète des opérations de gestion des partitions, notamment la suppression, la troncature et l'échange de partitions, consultez la page Partitioning Large Tables.

FAQ

Comment choisir la clé de partitionnement ?

Si la table possède une clé primaire, la clé de partitionnement doit être l'une des colonnes de cette clé primaire. En l'absence de clé primaire, vous pouvez spécifier n'importe quelle colonne comme clé de partitionnement. Pour optimiser l'élimination des partitions, choisissez la colonne qui apparaît le plus fréquemment dans les clauses WHERE.