> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Documentation sur PARTITION # Manipulation des partitions et des parties de données Les opérations suivantes sur les [partitions](/fr/reference/engines/table-engines/mergetree-family/custom-partitioning-key) sont disponibles : * [DETACH PARTITION|PART](#detach-partitionpart) — Déplace une partition ou une partie de données dans le répertoire `detached` et la détache. * [DROP PARTITION|PART](#drop-partitionpart) — Supprime une partition ou une partie de données. * [DROP DETACHED PARTITION|PART](#drop-detached-partitionpart) - Supprime une partie de données, ou toutes les parties de données d’une partition, depuis `detached`. * [FORGET PARTITION](#forget-partition) — Supprime les métadonnées d’une partition de ZooKeeper si elle est vide. * [ATTACH PARTITION|PART](#attach-partitionpart) — Ajoute à la table une partition ou une partie de données depuis le répertoire `detached`. * [ATTACH PARTITION FROM](#attach-partition-from) — Copie la partition de données d’une table vers une autre et l’y ajoute. * [REPLACE PARTITION](#replace-partition) — Copie la partition de données d’une table vers une autre et la remplace. * [MOVE PARTITION TO TABLE](#move-partition-to-table) — Déplace la partition de données d’une table vers une autre. * [CLEAR COLUMN IN PARTITION](#clear-column-in-partition) — Réinitialise la valeur d’une colonne spécifiée dans une partition. * [CLEAR INDEX IN PARTITION](#clear-index-in-partition) — Réinitialise l’index secondaire spécifié dans une partition. * [FREEZE PARTITION](#freeze-partition) — Crée une sauvegarde d’une partition. * [UNFREEZE PARTITION](#unfreeze-partition) — Supprime la sauvegarde d’une partition. * [FETCH PARTITION|PART](#fetch-partitionpart) — Télécharge une partie de données ou une partition depuis un autre serveur. * [MOVE PARTITION|PART](#move-partitionpart) — Déplace une partition/partie de données vers un autre disque ou volume. * [UPDATE IN PARTITION](#update-in-partition) — Met à jour les données à l’intérieur de la partition selon une condition. * [DELETE IN PARTITION](#delete-in-partition) — Supprime les données à l’intérieur de la partition selon une condition. * [REWRITE PARTS](#rewrite-parts) — Réécrit complètement les parties de données de la table (ou d’une partition spécifique).
## DETACH PARTITION|PART
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] DETACH PARTITION|PART partition_expr ``` Déplace toutes les données de la partition spécifiée vers le répertoire `detached`. Le serveur oublie cette partition de données détachée comme si elle n’existait pas. Le serveur n’aura pas connaissance de ces données tant que vous n’aurez pas exécuté la requête [ATTACH](#attach-partitionpart). Exemple : ```sql theme={null} ALTER TABLE mt DETACH PARTITION '2020-11-21'; ALTER TABLE mt DETACH PART 'all_2_2_0'; ``` Découvrez comment définir l’expression de partition dans la section [Comment définir l’expression de partition](#how-to-set-partition-expression). Une fois la requête exécutée, vous pouvez faire ce que vous voulez des données dans le répertoire `detached` — les supprimer du système de fichiers ou simplement les laisser. Cette requête est répliquée : elle déplace les données vers le répertoire `detached` sur toutes les répliques. Notez que vous ne pouvez exécuter cette requête que sur une réplique leader. Pour savoir si une réplique est leader, exécutez la requête `SELECT` sur la table [system.replicas](/fr/reference/system-tables/replicas). Sinon, il est plus simple d’effectuer une requête `DETACH` sur toutes les répliques : toutes les répliques renvoient une exception, sauf les répliques leader (car plusieurs leaders sont autorisés).
## DROP PARTITION|PART
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] DROP PARTITION|PART partition_expr ``` Supprime la partition spécifiée de la table. Cette requête marque la partition comme inactive et supprime complètement les données au bout d’environ 10 minutes. Pour en savoir plus sur la définition de l’expression de partition, consultez la section [Comment définir l’expression de partition](#how-to-set-partition-expression). La requête est répliquée : elle supprime les données sur toutes les répliques. Exemple : ```sql theme={null} ALTER TABLE mt DROP PARTITION '2020-11-21'; ALTER TABLE mt DROP PART 'all_4_4_0'; ```
## DROP DETACHED PARTITION|PART
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] DROP DETACHED PARTITION|PART ALL|partition_expr ``` Supprime la partie spécifiée, ou toutes les parties de la partition spécifiée, de `detached`. Pour en savoir plus sur la définition de l’expression de partition, consultez la section [Comment définir l’expression de partition](#how-to-set-partition-expression).
## FORGET PARTITION
```sql theme={null} ALTER TABLE table_name FORGET PARTITION partition_expr ``` Supprime de ZooKeeper toutes les métadonnées relatives à une partition vide. La requête échoue si la partition n'est pas vide ou si elle est inconnue. Veillez à n'exécuter cette opération que pour des partitions qui ne seront plus jamais utilisées. Consultez la section [Comment définir l'expression de partition](#how-to-set-partition-expression). Exemple : ```sql theme={null} ALTER TABLE mt FORGET PARTITION '20201121'; ```
## ATTACH PARTITION|PART
```sql theme={null} ALTER TABLE table_name ATTACH PARTITION|PART partition_expr ``` Ajoute des données à la table à partir du répertoire `detached`. Il est possible d’ajouter des données pour une partition entière ou pour une part distincte. Exemples : ```sql theme={null} ALTER TABLE visits ATTACH PARTITION 201901; ALTER TABLE visits ATTACH PART 201901_2_2_0; ``` Pour en savoir plus sur la définition de l’expression de partition, consultez la section [Comment définir l’expression de partition](#how-to-set-partition-expression). Cette requête est répliquée. La réplique initiatrice vérifie s’il y a des données dans le répertoire `detached`. Si des données existent, la requête en vérifie l’intégrité. Si tout est correct, la requête ajoute les données à la table. Si la réplique non initiatrice qui reçoit la commande ATTACH trouve la part avec les checksums corrects dans son propre répertoire `detached`, elle attache les données sans les récupérer depuis d’autres répliques. S’il n’existe aucune part avec les checksums corrects, les données sont téléchargées depuis n’importe quelle réplique qui possède cette part. Vous pouvez placer des données dans le répertoire `detached` sur une réplique et utiliser la requête `ALTER ... ATTACH` pour les ajouter à la table sur toutes les répliques.
## ATTACH PARTITION FROM
```sql theme={null} ALTER TABLE table2 [ON CLUSTER cluster] ATTACH PARTITION partition_expr FROM table1 ``` Cette requête copie la partition de données de `table1` vers `table2`. Notez que : * Les données ne seront supprimées ni de `table1` ni de `table2`. * `table1` peut être une table temporaire. Pour que la requête s’exécute avec succès, les conditions suivantes doivent être remplies : * Les deux tables doivent avoir la même structure. * Les deux tables doivent avoir la même clé de partition, la même clé ORDER BY et la même clé primaire. * Les deux tables doivent avoir la même politique de stockage. * La table de destination doit inclure tous les index et toutes les projections de la table source. Si le paramètre `enforce_index_structure_match_on_partition_manipulation` est activé pour la table de destination, les index et les projections doivent être identiques. Sinon, la table de destination peut contenir un surensemble des index et projections de la table source.
## REPLACE PARTITION
```sql theme={null} ALTER TABLE table2 [ON CLUSTER cluster] REPLACE PARTITION partition_expr FROM table1 ``` Cette requête copie la partition de données de `table1` vers `table2` et remplace la partition existante dans `table2`. L'opération est atomique. Notez que : * Les données ne seront pas supprimées de `table1`. * `table1` peut être une table temporaire. Pour que la requête s'exécute correctement, les conditions suivantes doivent être remplies : * Les deux tables doivent avoir la même structure. * Les deux tables doivent avoir la même clé de partition, la même clé ORDER BY et la même clé primaire. * Les deux tables doivent avoir la même politique de stockage. * La table de destination doit inclure tous les index et toutes les projections de la table source. Si le paramètre `enforce_index_structure_match_on_partition_manipulation` est activé dans la table de destination, les index et les projections doivent être identiques. Sinon, la table de destination peut avoir un surensemble des index et des projections de la table source.
## MOVE PARTITION TO TABLE
```sql theme={null} ALTER TABLE table_source [ON CLUSTER cluster] MOVE PARTITION partition_expr TO TABLE table_dest ``` Cette requête déplace la partition de données de `table_source` vers `table_dest` et supprime les données de `table_source`. Pour que la requête s'exécute correctement, les conditions suivantes doivent être remplies : * Les deux tables doivent avoir la même structure. * Les deux tables doivent avoir la même clé de partition, la même clé ORDER BY et la même clé primaire. * Les deux tables doivent avoir la même politique de stockage. * Les deux tables doivent appartenir à la même famille de moteurs (répliquée ou non répliquée). * La table de destination doit inclure tous les index et toutes les projections de la table source. Si le paramètre `enforce_index_structure_match_on_partition_manipulation` est activé pour la table de destination, les index et les projections doivent être identiques. Sinon, la table de destination peut contenir un surensemble des index et projections de la table source.
## CLEAR COLUMN IN PARTITION
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] CLEAR COLUMN column_name IN PARTITION partition_expr ``` Réinitialise toutes les valeurs de la colonne spécifiée dans une partition. Si la clause `DEFAULT` a été définie lors de la création de la table, cette requête affecte à la colonne la valeur par défaut spécifiée. Exemple : ```sql theme={null} ALTER TABLE visits CLEAR COLUMN hour in PARTITION 201902 ```
## FREEZE PARTITION
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] FREEZE [PARTITION partition_expr] [WITH NAME 'backup_name'] ``` Cette requête crée une sauvegarde locale d’une partition spécifiée. Si la clause `PARTITION` est omise, la requête crée la sauvegarde de toutes les partitions en une seule fois. L’intégralité du processus de sauvegarde s’effectue sans arrêter le serveur. Notez que, pour les tables d’ancien style, vous pouvez spécifier le préfixe du nom de partition (par exemple `2019`) ; la requête crée alors la sauvegarde de toutes les partitions correspondantes. Pour en savoir plus sur la définition de l’expression de partition, consultez la section [Comment définir l’expression de partition](#how-to-set-partition-expression). Au moment de l’exécution, pour créer un instantané des données, la requête crée des liens physiques vers les données de la table. Ces liens physiques sont placés dans le répertoire `/var/lib/clickhouse/shadow/N/...`, où : * `/var/lib/clickhouse/` est le répertoire de travail de ClickHouse spécifié dans la configuration. * `N` est le numéro incrémental de la sauvegarde. * si le paramètre `WITH NAME` est spécifié, la valeur du paramètre `'backup_name'` est utilisée à la place du numéro incrémental. Si vous utilisez [un ensemble de disques pour le stockage des données d’une table](/fr/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-multiple-volumes), le répertoire `shadow/N` apparaît sur chaque disque et stocke les parties de données correspondant à l’expression `PARTITION`. La même structure de répertoires est créée à l’intérieur de la sauvegarde que dans `/var/lib/clickhouse/`. La requête exécute `chmod` sur tous les fichiers afin d’en interdire l’écriture. Après avoir créé la sauvegarde, vous pouvez copier les données de `/var/lib/clickhouse/shadow/` vers le serveur distant, puis les supprimer du serveur local. Notez que la requête `ALTER t FREEZE PARTITION` n’est pas répliquée. Elle crée une sauvegarde locale uniquement sur le serveur local. La requête crée la sauvegarde presque instantanément (mais elle attend d’abord que les requêtes en cours sur la table correspondante soient terminées). `ALTER TABLE t FREEZE PARTITION` copie uniquement les données, pas les métadonnées de la table. Pour sauvegarder les métadonnées de la table, copiez le fichier `/var/lib/clickhouse/metadata/database/table.sql` Pour restaurer des données à partir d’une sauvegarde, procédez comme suit : 1. Créez la table si elle n’existe pas. Pour voir la requête, utilisez le fichier .sql (remplacez-y `ATTACH` par `CREATE`). 2. Copiez les données du répertoire `data/database/table/` à l’intérieur de la sauvegarde vers le répertoire `/var/lib/clickhouse/data/database/table/detached/`. 3. Exécutez les requêtes `ALTER TABLE t ATTACH PARTITION` pour ajouter les données à la table. La restauration à partir d’une sauvegarde ne nécessite pas d’arrêter le serveur. La requête traite les parties en parallèle ; le nombre de threads est régulé par le paramètre `max_threads`. Pour plus d’informations sur les sauvegardes et la restauration des données, consultez la section ["Sauvegarde et restauration dans ClickHouse"](/fr/concepts/features/backup-restore/overview).
## UNFREEZE PARTITION
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] UNFREEZE [PARTITION 'part_expr'] WITH NAME 'backup_name' ``` Supprime du disque les partitions `frozen` portant le nom spécifié. Si la clause `PARTITION` est omise, la requête supprime la sauvegarde de toutes les partitions d’un seul coup.
## CLEAR INDEX IN PARTITION
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] CLEAR INDEX index_name IN PARTITION partition_expr ``` La requête fonctionne comme `CLEAR COLUMN`, mais elle réinitialise un index au lieu des données d’une colonne.
## FETCH PARTITION|PART
```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] FETCH PARTITION|PART partition_expr FROM 'path-in-zookeeper' ``` Télécharge une partition depuis un autre serveur. Cette requête fonctionne uniquement pour les tables répliquées. La requête effectue les opérations suivantes : 1. Télécharge la partition|partie de données depuis le shard spécifié. Dans 'path-in-zookeeper', vous devez indiquer le chemin vers le shard dans ZooKeeper. 2. Ensuite, la requête place les données téléchargées dans le répertoire `detached` de la table `table_name`. Utilisez la requête [ATTACH PARTITION|PART](#attach-partitionpart) pour ajouter les données à la table. Par exemple : 1. FETCH PARTITION ```sql theme={null} ALTER TABLE users FETCH PARTITION 201902 FROM '/clickhouse/tables/01-01/visits'; ALTER TABLE users ATTACH PARTITION 201902; ``` 2. FETCH PART ```sql theme={null} ALTER TABLE users FETCH PART 201901_2_2_0 FROM '/clickhouse/tables/01-01/visits'; ALTER TABLE users ATTACH PART 201901_2_2_0; ``` Notez que : * La requête `ALTER ... FETCH PARTITION|PART` n'est pas répliquée. Elle place la partie de données ou la partition dans le répertoire `detached` uniquement sur le serveur local. * La requête `ALTER TABLE ... ATTACH` est répliquée. Elle ajoute les données à toutes les répliques. Les données sont ajoutées à l'une des répliques à partir du répertoire `detached`, et aux autres à partir des répliques voisines. Avant la récupération, le système vérifie que la partition existe et que la structure de la table correspond. La réplique la plus appropriée est automatiquement sélectionnée parmi les répliques saines. Bien que la requête s'appelle `ALTER TABLE`, elle ne modifie pas la structure de la table et ne change pas immédiatement les données disponibles dans la table.
## MOVE PARTITION|PART
Déplace des partitions ou des parties de données vers un autre volume ou disque pour les tables utilisant le moteur `MergeTree`. Voir [Utilisation de plusieurs périphériques de bloc pour le stockage des données](/fr/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-multiple-volumes). ```sql theme={null} ALTER TABLE table_name [ON CLUSTER cluster] MOVE PARTITION|PART partition_expr TO DISK|VOLUME 'disk_name' ``` La requête `ALTER TABLE t MOVE` : * N’est pas répliquée, car différentes répliques peuvent avoir des politiques de stockage différentes. * Renvoie une erreur si le disque ou le volume spécifié n’est pas configuré. La requête renvoie également une erreur si les conditions de déplacement des données définies dans la politique de stockage ne peuvent pas être appliquées. * Peut renvoyer une erreur si les données à déplacer ont déjà été déplacées par un processus d’arrière-plan, une requête `ALTER TABLE t MOVE` concurrente ou à la suite d’une fusion de données en arrière-plan. L’utilisateur ne doit effectuer aucune action supplémentaire dans ce cas. Exemple : ```sql theme={null} ALTER TABLE hits MOVE PART '20190301_14343_16206_438' TO VOLUME 'slow' ALTER TABLE hits MOVE PARTITION '2019-09-01' TO DISK 'fast_ssd' ```
## UPDATE IN PARTITION
Manipule les données de la partition spécifiée qui correspondent à l’expression de filtrage indiquée. Cette opération est implémentée sous forme de [mutation](/fr/reference/statements/alter/index#mutations). Syntaxe : ```sql theme={null} ALTER TABLE [db.]table [ON CLUSTER cluster] UPDATE column1 = expr1 [, ...] [IN PARTITION partition_expr] WHERE filter_expr ```
### Exemple
```sql theme={null} -- using partition name ALTER TABLE mt UPDATE x = x + 1 IN PARTITION 2 WHERE p = 2; -- using partition id ALTER TABLE mt UPDATE x = x + 1 IN PARTITION ID '2' WHERE p = 2; ```
### Voir aussi
* [UPDATE](/fr/reference/statements/alter/partition#update-in-partition)
## DELETE IN PARTITION
Supprime les données de la partition spécifiée qui correspondent à l'expression de filtrage indiquée. Cette opération est implémentée sous forme de [mutation](/fr/reference/statements/alter/index#mutations). Syntaxe : ```sql theme={null} ALTER TABLE [db.]table [ON CLUSTER cluster] DELETE [IN PARTITION partition_expr] WHERE filter_expr ```
### Exemple
```sql theme={null} -- using partition name ALTER TABLE mt DELETE IN PARTITION 2 WHERE p = 2; -- using partition id ALTER TABLE mt DELETE IN PARTITION ID '2' WHERE p = 2; ```
## REWRITE PARTS
Cette opération réécrira les parties de données à partir de zéro, en appliquant tous les nouveaux paramètres. Cela se justifie, car les paramètres au niveau de la table, comme `use_const_adaptive_granularity`, ne sont par défaut appliqués qu’aux parties de données nouvellement écrites.
### Exemple
```sql theme={null} ALTER TABLE mt REWRITE PARTS; ALTER TABLE mt REWRITE PARTS IN PARTITION 2; ```
### Voir aussi
* [DELETE](/fr/reference/statements/alter/delete)
## Comment définir l’expression de partition
Vous pouvez spécifier l’expression de partition dans les requêtes `ALTER ... PARTITION` de différentes manières : * Comme une valeur de la colonne `partition` de la table `system.parts`. Par exemple, `ALTER TABLE visits DETACH PARTITION 201901`. * En utilisant le mot-clé `ALL`. Il ne peut être utilisé qu’avec DROP/DETACH/ATTACH/ATTACH FROM. Par exemple, `ALTER TABLE visits ATTACH PARTITION ALL`. * Comme un tuple d’expressions ou de constantes correspondant (par leurs types) au tuple des clés de partitionnement de la table. Dans le cas d’une clé de partitionnement à un seul élément, l’expression doit être enveloppée dans la fonction `tuple (...)`. Par exemple, `ALTER TABLE visits DETACH PARTITION tuple(toYYYYMM(toDate('2019-01-25')))`. * En utilisant l’ID de partition. L’ID de partition est un identifiant de chaîne de la partition (lisible par l’humain, si possible), utilisé comme nom des partitions dans le système de fichiers et dans ZooKeeper. L’ID de partition doit être spécifié dans la clause `PARTITION ID`, entre guillemets simples. Par exemple, `ALTER TABLE visits DETACH PARTITION ID '201901'`. * Dans les requêtes [ALTER ATTACH PART](#attach-partitionpart) et [DROP DETACHED PART](#drop-detached-partitionpart), pour spécifier le nom d’une partie de données, utilisez un littéral de chaîne contenant une valeur de la colonne `name` de la table [system.detached\_parts](/fr/reference/system-tables/detached_parts). Par exemple, `ALTER TABLE visits ATTACH PART '201901_1_1_0'`. L’utilisation des guillemets lors de la spécification de la partition dépend du type de l’expression de partition. Par exemple, pour le type `String`, vous devez indiquer son nom entre guillemets (`'`). Pour les types `Date` et `Int*`, aucun guillemet n’est nécessaire. Toutes les règles ci-dessus s’appliquent également à la requête [OPTIMIZE](/fr/reference/statements/optimize). Si vous devez spécifier l’unique partition lors de l’optimisation d’une table non partitionnée, définissez l’expression `PARTITION tuple()`. Par exemple : ```sql theme={null} OPTIMIZE TABLE table_not_partitioned PARTITION tuple() FINAL; ``` `IN PARTITION` spécifie la partition à laquelle les expressions [UPDATE](/fr/reference/statements/alter/update) ou [DELETE](/fr/reference/statements/alter/delete) sont appliquées à la suite de la requête `ALTER TABLE`. De nouvelles parties de données sont créées uniquement à partir de la partition spécifiée. Ainsi, `IN PARTITION` permet de réduire la charge lorsque la table est divisée en un grand nombre de partitions et que vous n’avez besoin de mettre à jour les données que ponctuellement. Des exemples de requêtes `ALTER ... PARTITION` sont présentés dans les tests [`00502_custom_partitioning_local`](https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/00502_custom_partitioning_local.sql) et [`00502_custom_partitioning_replicated_zookeeper`](https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/00502_custom_partitioning_replicated_zookeeper.sql).