```
### SYSTEM WAIT LOADING PARTS
Attend le chargement de toutes les parts de données d’une table chargées de manière asynchrone (parts de données obsolètes).
```sql theme={null}
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
```
## Gestion des tables ReplicatedMergeTree
ClickHouse peut gérer les processus de réplication en arrière-plan dans les tables [ReplicatedMergeTree](/fr/reference/engines/table-engines/mergetree-family/replication).
### SYSTEM STOP FETCHES
Permet d'arrêter les opérations de récupération en arrière-plan des parts insérées pour les tables de la famille `ReplicatedMergeTree` :
Renvoie toujours `Ok.`, quel que soit le moteur de table, même si la table ou la base de données n'existe pas.
```sql theme={null}
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START FETCHES
Permet de lancer les opérations de récupération en arrière-plan des parts insérées pour les tables de la famille `ReplicatedMergeTree` :
Renvoie toujours `Ok.`, quel que soit le moteur de table, même si la table ou la base de données n’existe pas.
```sql theme={null}
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATED SENDS
Permet d’arrêter les envois en arrière-plan vers d’autres répliques du cluster des nouvelles parts insérées pour les tables de la famille `ReplicatedMergeTree` :
```sql theme={null}
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATED SENDS
Permet de démarrer les envois en arrière-plan vers d’autres répliques du cluster pour les nouvelles parts de données insérées des tables de la famille `ReplicatedMergeTree` :
```sql theme={null}
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATION QUEUES
Permet d'arrêter les tâches de récupération en arrière-plan des files d'attente de réplication stockées dans ZooKeeper pour les tables de la famille `ReplicatedMergeTree`. Types possibles de tâches en arrière-plan - fusions, récupérations, mutations, instructions DDL avec la clause ON CLUSTER :
```sql theme={null}
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATION QUEUES
Permet de démarrer les tâches de récupération en arrière-plan depuis les files d’attente de réplication stockées dans ZooKeeper pour les tables de la famille `ReplicatedMergeTree`. Types possibles de tâches en arrière-plan : fusions, récupérations, mutations, instructions DDL avec la clause ON CLUSTER :
```sql theme={null}
SYSTEM START REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP PULLING REPLICATION LOG
Arrête le chargement des nouvelles entrées du journal de réplication vers la file d’attente de réplication d’une table `ReplicatedMergeTree`.
```sql theme={null}
SYSTEM STOP PULLING REPLICATION LOG [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START PULLING REPLICATION LOG
Annule l’effet de `SYSTEM STOP PULLING REPLICATION LOG`.
```sql theme={null}
SYSTEM START PULLING REPLICATION LOG [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM SYNC REPLICA
Attendez qu'une table `ReplicatedMergeTree` soit synchronisée avec les autres répliques d'un cluster, sans dépasser `receive_timeout` secondes.
```sql theme={null}
SYSTEM SYNC REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name [IF EXISTS] [STRICT | LIGHTWEIGHT [FROM 'srcReplica1'[, 'srcReplica2'[, ...]]] | PULL]
```
Après l’exécution de cette instruction, `[db.]replicated_merge_tree_family_table_name` récupère les commandes du journal répliqué commun dans sa propre file de réplication, puis la requête attend que la réplique traite toutes les commandes récupérées. Les modificateurs suivants sont pris en charge :
* Avec `IF EXISTS` (disponible à partir de la version 25.6), la requête ne renverra pas d’erreur si la table n’existe pas. Cela est utile lors de l’ajout d’une nouvelle réplique à un cluster, lorsqu’elle fait déjà partie de la configuration du cluster mais qu’elle est encore en cours de création et de synchronisation de la table.
* Si un modificateur `STRICT` a été spécifié, la requête attend que la file de réplication soit vide. La version `STRICT` peut ne jamais aboutir si de nouvelles entrées apparaissent constamment dans la file de réplication.
* Si un modificateur `LIGHTWEIGHT` a été spécifié, la requête attend uniquement que les entrées `GET_PART`, `ATTACH_PART`, `DROP_RANGE`, `REPLACE_RANGE` et `DROP_PART` soient traitées.
De plus, le modificateur LIGHTWEIGHT prend en charge une clause facultative `FROM 'srcReplicas'`, où 'srcReplicas' est une liste de noms de répliques sources séparés par des virgules. Cette extension permet une synchronisation plus ciblée en se concentrant uniquement sur les tâches de réplication provenant des répliques sources spécifiées.
* Si un modificateur `PULL` a été spécifié, la requête récupère de nouvelles entrées de la file de réplication depuis ZooKeeper, mais n’attend pas leur traitement.
### SYNCHRONISER LA RÉPLIQUE DE LA BASE DE DONNÉES
Attend jusqu’à ce que la [base de données répliquée](/fr/reference/engines/database-engines/replicated) spécifiée applique toutes les modifications de schéma de la file d’attente DDL de cette base de données.
**Syntaxe**
```sql theme={null}
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
```
### SYSTEM RESTART REPLICA
Permet de réinitialiser l’état de la session ZooKeeper pour la table `ReplicatedMergeTree`, de comparer l’état actuel à celui de ZooKeeper, qui sert de source de référence, et d’ajouter des tâches à la file d’attente ZooKeeper si nécessaire.
L’initialisation de la file d’attente de réplication à partir des données ZooKeeper s’effectue de la même manière que pour l’instruction `ATTACH TABLE`. Pendant une courte période, la table sera indisponible pour toute opération.
```sql theme={null}
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
### SYSTEM RESTORE REPLICA
Restaure une réplique si les données sont \[potentiellement] présentes, mais que les métadonnées ZooKeeper ont été perdues.
Fonctionne uniquement sur les tables `ReplicatedMergeTree` en mode readonly.
Cette requête peut être exécutée après :
* la perte de la racine ZooKeeper `/` ;
* la perte du chemin des répliques `/replicas` ;
* la perte du chemin d'une réplique individuelle `/replicas/replica_name/`.
La réplique attache les parts trouvées localement et envoie à ZooKeeper des informations à leur sujet.
Les parts présentes sur une réplique avant la perte des métadonnées ne sont pas récupérées de nouveau depuis d'autres répliques si elles ne sont pas obsolètes (la restauration d'une réplique ne signifie donc pas le retéléchargement de toutes les données sur le réseau).
Les parts dans tous les états sont déplacées vers le dossier `detached/`. Les parts actives avant la perte des données (`committed`) sont attachées.
### SYSTEM RESTORE DATABASE REPLICA
Restaure une réplique si des données sont \[éventuellement] présentes, mais que les métadonnées de ZooKeeper sont perdues.
**Syntaxe**
```sql theme={null}
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
```
**Exemple**
```sql theme={null}
CREATE DATABASE repl_db
ENGINE=Replicated("/clickhouse/repl_db", shard1, replica1);
CREATE TABLE repl_db.test_table (n UInt32)
ENGINE = ReplicatedMergeTree
ORDER BY n PARTITION BY n % 10;
-- zookeeper_delete_path("/clickhouse/repl_db", recursive=True) <- root loss.
SYSTEM RESTORE DATABASE REPLICA repl_db;
```
**Syntaxe**
```sql theme={null}
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
```
Autre syntaxe :
```sql theme={null}
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
**Exemple**
Création d'une table sur plusieurs serveurs. Après la perte des métadonnées de la réplique dans ZooKeeper, la table sera attachée en lecture seule, faute de métadonnées. La dernière requête doit être exécutée sur chaque réplique.
```sql theme={null}
CREATE TABLE test(n UInt32)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/', '{replica}')
ORDER BY n PARTITION BY n % 10;
INSERT INTO test SELECT * FROM numbers(1000);
-- zookeeper_delete_path("/clickhouse/tables/test", recursive=True) <- root loss.
SYSTEM RESTART REPLICA test;
SYSTEM RESTORE REPLICA test;
```
Une autre méthode :
```sql theme={null}
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
```
### SYSTEM RESTART REPLICAS
Permet de réinitialiser l’état des sessions Zookeeper pour toutes les tables `ReplicatedMergeTree`, de comparer l’état actuel avec celui de Zookeeper, considéré comme source de vérité, et d’ajouter des tâches à la file d’attente de Zookeeper si nécessaire
### SYSTEM CLEAR|DROP FILESYSTEM CACHE
Permet de supprimer le cache du système de fichiers.
```sql theme={null}
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
```
### SYSTEM SYNC FILE CACHE
Cette opération est trop lourde et peut faire l’objet d’une mauvaise utilisation.
Exécute l’appel système sync.
```sql theme={null}
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
```
### SYSTEM LOAD PRIMARY KEY
Charge les clés primaires de la table indiquée ou de toutes les tables.
```sql theme={null}
SYSTEM LOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM LOAD PRIMARY KEY
```
### SYSTEM UNLOAD PRIMARY KEY
Décharge les clés primaires de la table spécifiée ou de toutes les tables.
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY
```
## Gestion des vues matérialisées avec rafraîchissement
Commandes permettant de contrôler les tâches d'arrière-plan exécutées par les [vues matérialisées avec rafraîchissement](/fr/reference/statements/create/view#refreshable-materialized-view)
Surveillez [`system.view_refreshes`](/fr/reference/system-tables/view_refreshes) lors de leur utilisation.
### SYSTEM STOP \[REPLICATED] VIEW, STOP VIEWS
Désactive l’actualisation périodique de la vue spécifiée ou de toutes les vues actualisables. Si une actualisation est en cours, elle est également annulée.
Si la vue se trouve dans une base de données Replicated ou Shared, `STOP VIEW` n’affecte que la réplique courante, tandis que `STOP REPLICATED VIEW` affecte toutes les répliques.
L’état d’arrêt n’est pas conservé après un redémarrage du serveur. Après redémarrage, les vues reprennent leur planification d’actualisation configurée.
Dans les bases de données Replicated ou Shared, `SYSTEM STOP VIEW` n’affecte que la réplique courante. Utilisez `SYSTEM STOP REPLICATED VIEW` pour arrêter les actualisations sur toutes les répliques.
```sql theme={null}
SYSTEM STOP VIEW [db.]name
```
```sql theme={null}
SYSTEM STOP VIEWS
```
### SYSTEM START \[REPLICATED] VIEW, START VIEWS
Active l'actualisation périodique pour la vue indiquée ou pour toutes les vues actualisables. Aucun rafraîchissement immédiat n'est déclenché.
Si la vue se trouve dans une base de données Replicated ou Shared, `START VIEW` annule l'effet de `STOP VIEW`, et `START REPLICATED VIEW` annule l'effet de `STOP REPLICATED VIEW`. `START VIEW` annule également l'effet de `PAUSE VIEW`.
```sql theme={null}
SYSTEM START VIEW [db.]name
```
```sql theme={null}
SYSTEM START VIEWS
```
### SYSTEM PAUSE VIEW, PAUSE VIEWS
Désactive le rafraîchissement périodique de la vue spécifiée ou de toutes les vues actualisables.
Contrairement à `SYSTEM STOP VIEW`, `SYSTEM PAUSE VIEW` n’interrompt pas un rafraîchissement déjà en cours : le rafraîchissement en cours peut aller à son terme, et seules les rafraîchissements suivantes sont empêchées.
Pour annuler, utilisez `SYSTEM START VIEW` ou `SYSTEM START VIEWS`.
L’état en pause ne persiste pas après un redémarrage du serveur. Après le redémarrage, les vues reprendront leur planification de rafraîchissement configurée.
Dans les bases de données Replicated ou Shared, `SYSTEM PAUSE VIEW` n’affecte que la réplique actuelle.
```sql theme={null}
SYSTEM PAUSE VIEW [db.]name
```
```sql theme={null}
SYSTEM PAUSE VIEWS
```
### SYSTEM REFRESH VIEW
Déclenche un rafraîchissement immédiat d’une vue donnée en dehors de la planification prévue.
```sql theme={null}
SYSTEM REFRESH VIEW [db.]name
```
### SYSTEM WAIT VIEW
Attend la fin du rafraîchissement en cours. Si aucun rafraîchissement n’est en cours, la commande retourne immédiatement. Si la dernière tentative de rafraîchissement a échoué, elle signale une erreur.
Peut être utilisée juste après la création d’une nouvelle vue matérialisée actualisable (sans le mot-clé EMPTY) pour attendre la fin du rafraîchissement initial.
Si la vue se trouve dans une base de données Replicated ou Shared, et qu’un rafraîchissement est en cours sur une autre réplique, attend la fin de ce rafraîchissement.
```sql theme={null}
SYSTEM WAIT VIEW [db.]name
```
### SYSTEM CANCEL VIEW
S'il y a un rafraîchissement en cours pour la vue spécifiée sur la réplique actuelle, interrompez-le et annulez-le. Sinon, ne faites rien.
```sql theme={null}
SYSTEM CANCEL VIEW [db.]name
```
## SYSTEM FLUSH OBJECT STORAGE QUEUE
Bloque l’exécution jusqu’à ce que le fichier indiqué ait été traité ou ait définitivement échoué dans la table [S3Queue](/fr/reference/engines/table-engines/integrations/s3queue) ou [AzureQueue](/fr/reference/engines/table-engines/integrations/azure-queue) donnée. Renvoie immédiatement si le fichier a déjà été traité. Génère une erreur si le fichier a définitivement échoué (toutes les tentatives de nouvelle exécution ont été épuisées).
```sql theme={null}
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
```