```
### SYSTEM WAIT LOADING PARTS
等待，直到表中所有异步加载的数据分区片段 (过期数据分区片段) 均已完成加载。
```sql theme={null}
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
```
## 管理 ReplicatedMergeTree 表
ClickHouse 可以管理 [ReplicatedMergeTree](/zh/reference/engines/table-engines/mergetree-family/replication) 表中与后台复制相关的进程。
### SYSTEM STOP FETCHES
可停止 `ReplicatedMergeTree` 家族表中已插入 parts 的后台拉取操作：
无论表引擎为何，甚至表或数据库不存在，始终返回 `Ok.`
```sql theme={null}
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START FETCHES
可为 `ReplicatedMergeTree` 家族中的表启动针对已插入 parts 的后台拉取：
无论表引擎是什么，甚至表或数据库不存在，也始终返回 `Ok.`。
```sql theme={null}
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATED SENDS
可停止 `ReplicatedMergeTree` 家族表中新插入的 parts 向集群中其他副本的后台发送：
```sql theme={null}
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATED SENDS
可为 `ReplicatedMergeTree` 家族中的表启动后台发送，将新插入的 parts 发送到集群中的其他副本：
```sql theme={null}
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATION QUEUES
可停止存储在 Zookeeper 中、供 `ReplicatedMergeTree` 家族表使用的复制队列里的后台拉取任务。可能的后台任务类型包括：合并、拉取、变更，以及带有 ON CLUSTER 子句的 DDL 语句：
```sql theme={null}
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATION QUEUES
可为 `ReplicatedMergeTree` 家族中的表启动存储在 ZooKeeper 中的复制队列里的后台任务。可能的后台任务类型包括：合并、拉取、变更，以及带有 ON CLUSTER 子句的 DDL 语句：
```sql theme={null}
SYSTEM START REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP PULLING REPLICATION LOG
停止将新条目从复制日志加载到 `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
撤销 `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
等待 `ReplicatedMergeTree` 表与集群中的其他副本完成同步，但等待时间不超过 `receive_timeout` 秒。
```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]
```
运行此语句后，`[db.]replicated_merge_tree_family_table_name` 会将公共复制日志中的命令拉取到自己的复制队列中，然后该查询会一直等待，直到副本处理完所有已拉取的命令。支持以下修饰符：
* 使用 `IF EXISTS` (自 25.6 起可用) 时，如果表不存在，查询不会抛出错误。这在向集群中添加新副本时很有用：此时它可能已经属于集群配置的一部分，但表仍在创建和同步过程中。
* 如果指定了 `STRICT` 修饰符，则查询会等待复制队列清空。如果复制队列中持续出现新的条目，则 `STRICT` 版本可能永远不会成功。
* 如果指定了 `LIGHTWEIGHT` 修饰符，则查询仅等待 `GET_PART`、`ATTACH_PART`、`DROP_RANGE`、`REPLACE_RANGE` 和 `DROP_PART` 条目处理完成。
此外，`LIGHTWEIGHT` 修饰符还支持可选的 `FROM 'srcReplicas'` 子句，其中 `'srcReplicas'` 是以逗号分隔的源副本名称列表。此扩展可实现更有针对性的同步，只关注源自指定源副本的复制任务。
* 如果指定了 `PULL` 修饰符，则查询会从 ZooKeeper 拉取新的复制队列条目，但不会等待任何内容被处理。
### SYNC DATABASE REPLICA
等待指定的[Replicated 数据库](/zh/reference/engines/database-engines/replicated)应用该数据库 DDL 队列中的所有 schema 变更。
**语法**
```sql theme={null}
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
```
### SYSTEM RESTART REPLICA
可重新初始化 `ReplicatedMergeTree` 表的 Zookeeper 会话状态；系统会将当前状态与作为事实来源的 Zookeeper 进行比较，并在需要时向 Zookeeper 队列添加任务。
基于 ZooKeeper 数据初始化复制队列的方式与 `ATTACH TABLE` 语句相同。在短时间内，该表将暂时无法执行任何操作。
```sql theme={null}
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
### SYSTEM RESTORE REPLICA
如果数据\[可能]仍然存在，但 ZooKeeper 元数据已丢失，则可恢复副本。
仅适用于只读的 `ReplicatedMergeTree` 表。
可在以下情况发生后执行该查询：
* ZooKeeper 根路径 `/` 丢失。
* 副本路径 `/replicas` 丢失。
* 单个副本路径 `/replicas/replica_name/` 丢失。
副本会附加在本地找到的 parts，并将这些 parts 的信息发送到 ZooKeeper。
如果副本上的 parts 在元数据丢失前就已存在，且未过期，则不会从其他副本重新拉取 (因此，恢复副本并不意味着要通过网络重新下载所有数据) 。
所有状态的 parts 都会被移到 `detached/` 文件夹中。数据丢失前处于活动状态 (committed) 的 parts 会被附加。
### SYSTEM RESTORE DATABASE REPLICA
在\[可能]存在数据但 Zookeeper 元数据已丢失时，恢复副本。
**语法**
```sql theme={null}
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
```
**示例**
```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) <- 根节点丢失。
SYSTEM RESTORE DATABASE REPLICA repl_db;
```
**语法**
```sql theme={null}
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
```
另一种语法：
```sql theme={null}
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
**示例**
在多个服务器上创建表。若 ZooKeeper 中的副本元数据丢失，由于缺少元数据，该表会以只读方式附加。最后一个查询需要在每个副本上执行。
```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) <- 根节点丢失。
SYSTEM RESTART REPLICA test;
SYSTEM RESTORE REPLICA test;
```
另一种方法：
```sql theme={null}
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
```
### SYSTEM RESTART REPLICAS
可为所有 `ReplicatedMergeTree` 表重新初始化 Zookeeper 会话状态；它会将当前状态与 Zookeeper 中的状态进行比较，并以 Zookeeper 中的状态为准，必要时向 Zookeeper 队列添加任务
### SYSTEM CLEAR|DROP FILESYSTEM CACHE
用于清空文件系统缓存。
```sql theme={null}
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
```
### SYSTEM SYNC FILE CACHE
此操作开销过大，且存在被滥用的风险。
会执行 sync 系统调用。
```sql theme={null}
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
```
### SYSTEM LOAD PRIMARY KEY
加载指定表或所有表的主键。
```sql theme={null}
SYSTEM LOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM LOAD PRIMARY KEY
```
### SYSTEM UNLOAD PRIMARY KEY
卸载指定表或所有表的主键。
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY
```
## 管理可刷新的 materialized view
用于控制[可刷新的 materialized view](/zh/reference/statements/create/view#refreshable-materialized-view)执行的后台任务的命令
在使用这类视图时，请留意 [`system.view_refreshes`](/zh/reference/system-tables/view_refreshes)。
### SYSTEM STOP \[REPLICATED] VIEW, STOP VIEWS
禁用指定视图或所有可刷新的视图的周期性刷新。如果当前有刷新正在进行，也会一并取消。
如果视图位于 Replicated 或 Shared 数据库 中，`STOP VIEW` 仅影响当前副本，而 `STOP REPLICATED VIEW` 会影响所有副本。
停止后的状态不会在 server 重启后保留。重启后，视图将恢复按其已配置的刷新计划执行。
在 Replicated 或 Shared 数据库 中，`SYSTEM STOP VIEW` 仅影响当前副本。使用 `SYSTEM STOP REPLICATED VIEW` 可停止所有副本上的刷新。
```sql theme={null}
SYSTEM STOP VIEW [db.]name
```
```sql theme={null}
SYSTEM STOP VIEWS
```
### SYSTEM START \[REPLICATED] VIEW, START VIEWS
为指定视图或所有可刷新的视图启用周期性刷新。不会立即触发刷新。
如果视图位于 Replicated 或 Shared database 中，`START VIEW` 会撤销 `STOP VIEW` 的效果，`START REPLICATED VIEW` 会撤销 `STOP REPLICATED VIEW` 的效果。`START VIEW` 还会撤销 `PAUSE VIEW` 的效果。
```sql theme={null}
SYSTEM START VIEW [db.]name
```
```sql theme={null}
SYSTEM START VIEWS
```
### SYSTEM PAUSE VIEW, PAUSE VIEWS
禁用指定视图或所有可刷新的视图的周期性刷新。
与 `SYSTEM STOP VIEW` 不同，`SYSTEM PAUSE VIEW` 不会中断已在进行的刷新：当前正在运行的刷新会正常完成，只会阻止后续刷新。
可使用 `SYSTEM START VIEW` 或 `SYSTEM START VIEWS` 恢复。
暂停状态在 server 重启后不会保留。重启后，视图将恢复为其配置的刷新计划。
在 Replicated 或 Shared 数据库中，`SYSTEM PAUSE VIEW` 仅影响当前副本。
```sql theme={null}
SYSTEM PAUSE VIEW [db.]name
```
```sql theme={null}
SYSTEM PAUSE VIEWS
```
### SYSTEM REFRESH VIEW
立即触发对指定视图的一次计划外刷新。
```sql theme={null}
SYSTEM REFRESH VIEW [db.]name
```
### SYSTEM WAIT VIEW
等待正在进行中的刷新完成。如果当前没有刷新在运行，则会立即返回。如果最近一次刷新尝试失败，则会报错。
可在创建新的可刷新materialized view 后 (不带 EMPTY 关键字) 立即使用，以等待初始刷新完成。
如果该视图位于 Replicated 或 Shared database 中，且刷新正在另一副本上运行，则会等待该刷新完成。
```sql theme={null}
SYSTEM WAIT VIEW [db.]name
```
### SYSTEM CANCEL VIEW
如果当前副本上的指定视图正在刷新，则中断并取消该刷新。否则，不执行任何操作。
```sql theme={null}
SYSTEM CANCEL VIEW [db.]name
```
## SYSTEM FLUSH OBJECT STORAGE QUEUE
阻塞执行，直到指定文件被给定的 [S3Queue](/zh/reference/engines/table-engines/integrations/s3queue) 或 [AzureQueue](/zh/reference/engines/table-engines/integrations/azure-queue) 表处理完成，或永久失败为止。如果该文件已处理完成，则会立即返回。如果该文件已永久失败 (即所有重试都已耗尽) ，则会引发错误。
```sql theme={null}
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
```