```
### SYSTEM WAIT LOADING PARTS
테이블에서 비동기적으로 로딩되는 모든 데이터 파트(data part)(오래된 데이터 파트)가 로딩될 때까지 기다립니다.
```sql theme={null}
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
```
## ReplicatedMergeTree 테이블 관리
ClickHouse는 [ReplicatedMergeTree](/ko/reference/engines/table-engines/mergetree-family/replication) 테이블의 복제 관련 백그라운드 프로세스를 관리할 수 있습니다.
### SYSTEM STOP FETCHES
`ReplicatedMergeTree` 계열의 테이블에서 삽입된 파트의 백그라운드 페치를 중지할 수 있습니다:
테이블 엔진과 무관하게, 테이블이나 데이터베이스가 존재하지 않아도 항상 `Ok.`를 반환합니다.
```sql theme={null}
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START FETCHES
`ReplicatedMergeTree` 계열 테이블의 삽입된 파트에 대한 백그라운드 페치를 시작할 수 있습니다.
테이블 엔진과 무관하게, 테이블이나 데이터베이스가 존재하지 않아도 항상 `Ok.`를 반환합니다.
```sql theme={null}
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATED SENDS
`ReplicatedMergeTree` 계열 테이블에서 새로 삽입된 파트를 클러스터의 다른 레플리카로 백그라운드에서 전송하는 작업을 중지할 수 있습니다:
```sql theme={null}
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATED SENDS
`ReplicatedMergeTree` 계열 테이블에서 새로 삽입된 파트를 클러스터 내 다른 레플리카로 보내는 백그라운드 작업을 시작할 수 있습니다:
```sql theme={null}
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATION QUEUES
`ReplicatedMergeTree` 계열 테이블에서는 Zookeeper에 저장된 복제 큐의 백그라운드 fetch 작업을 중지할 수 있습니다. 가능한 백그라운드 작업 유형은 merges, fetches, mutation, 그리고 ON CLUSTER 절이 포함된 DDL SQL 문입니다:
```sql theme={null}
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATION QUEUES
`ReplicatedMergeTree` 계열 테이블의 경우 Zookeeper에 저장된 복제 큐에서 백그라운드 fetch 작업을 시작할 수 있습니다. 가능한 백그라운드 작업 유형은 머지, fetch, mutation, ON CLUSTER 절이 포함된 DDL SQL 문입니다:
```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
지정된 [복제된 데이터베이스](/ko/reference/engines/database-engines/replicated)가 해당 데이터베이스의 DDL 큐에 있는 모든 스키마 변경 사항을 적용할 때까지 대기합니다.
**구문**
```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/` 손실.
레플리카는 로컬에서 찾은 파트를 ATTACH하고, 해당 정보를 Zookeeper에 전송합니다.
메타데이터 손실 전에 레플리카에 있던 파트는 `outdated` 상태가 아닌 한 다른 레플리카에서 다시 가져오지 않습니다(즉, 레플리카 복원은 네트워크를 통해 모든 데이터를 다시 다운로드한다는 뜻이 아닙니다).
모든 상태의 파트는 `detached/` 폴더로 이동됩니다. 데이터 손실 전에 활성 상태였던(커밋된) 파트는 ATTACH됩니다.
### 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에 저장된 레플리카 메타데이터가 손실되면 메타데이터가 없기 때문에 해당 테이블은 읽기 전용으로 ATTACH됩니다. 마지막 쿼리는 모든 레플리카에서 실행해야 합니다.
```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 큐에 작업을 추가합니다.
### 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
지정한 테이블(table) 또는 모든 테이블의 기본 키(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
```
## 갱신 가능 구체화 뷰 관리
[갱신 가능 구체화 뷰](/ko/reference/statements/create/view#refreshable-materialized-view)가 수행하는 백그라운드 작업을 제어하는 명령입니다.
사용하는 동안에는 [`system.view_refreshes`](/ko/reference/system-tables/view_refreshes)를 주기적으로 확인하십시오.
### SYSTEM STOP \[REPLICATED] VIEW, STOP VIEWS
지정한 뷰 또는 모든 갱신 가능한 뷰의 주기적 갱신을 중지합니다. 갱신이 진행 중인 경우 해당 작업도 취소합니다.
뷰가 Replicated 또는 Shared 데이터베이스에 있는 경우, `STOP VIEW`는 현재 레플리카에만 영향을 미치고, `STOP REPLICATED VIEW`는 모든 레플리카에 영향을 미칩니다.
중지된 상태는 서버를 재시작해도 유지되지 않습니다. 재시작 후에는 뷰가 구성된 갱신 일정에 따라 다시 갱신됩니다.
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 데이터베이스에 있는 경우, `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
현재 실행 중인 갱신이 완료될 때까지 기다립니다. 실행 중인 갱신이 없으면 즉시 반환됩니다. 가장 최근 갱신 시도가 실패한 경우 오류를 보고합니다.
새 갱신 가능 구체화 뷰를 생성한 직후(`EMPTY` 키워드 없이) 초기 갱신이 완료될 때까지 기다리는 데 사용할 수 있습니다.
뷰가 `Replicated` 또는 `Shared` 데이터베이스에 있고 다른 레플리카에서 갱신이 실행 중인 경우, 해당 갱신이 완료될 때까지 기다립니다.
```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](/ko/reference/engines/table-engines/integrations/s3queue) 또는 [AzureQueue](/ko/reference/engines/table-engines/integrations/azure-queue) 테이블이 지정된 파일을 처리하거나 해당 파일의 영구적 실패를 확정할 때까지 대기합니다. 파일이 이미 처리된 경우에는 즉시 반환됩니다. 파일이 영구적으로 실패한 경우(모든 재시도를 소진한 경우) 오류를 발생시킵니다.
```sql theme={null}
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
```