```
### SYSTEM WAIT LOADING PARTS
Aguarde até que todas as partes de dados de uma tabela carregadas de forma assíncrona (partes de dados desatualizadas) sejam carregadas.
```sql theme={null}
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
```
## Gerenciando tabelas ReplicatedMergeTree
O ClickHouse pode gerenciar, em segundo plano, os processos relacionados à replicação em tabelas [ReplicatedMergeTree](/pt-BR/reference/engines/table-engines/mergetree-family/replication).
### SYSTEM STOP FETCHES
Permite interromper os fetches em segundo plano de partes inseridas em tabelas da família `ReplicatedMergeTree`:
Sempre retorna `Ok.`, independentemente do motor da tabela, mesmo que a tabela ou o banco de dados não existam.
```sql theme={null}
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START FETCHES
Oferece a possibilidade de iniciar fetches em segundo plano para partes inseridas em tabelas da família `ReplicatedMergeTree`:
Sempre retorna `Ok.` independentemente do motor da tabela, mesmo que a tabela ou o banco de dados não existam.
```sql theme={null}
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATED SENDS
Permite interromper, em segundo plano, o envio de novas partes inseridas para outras réplicas no cluster em tabelas da família `ReplicatedMergeTree`:
```sql theme={null}
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATED SENDS
Permite iniciar, em segundo plano, o envio de novas partes inseridas para outras réplicas no cluster em tabelas da família `ReplicatedMergeTree`:
```sql theme={null}
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATION QUEUES
Permite interromper tarefas de fetch em segundo plano das filas de replicação armazenadas no ZooKeeper para tabelas da família `ReplicatedMergeTree`. Os possíveis tipos de tarefas em segundo plano são: merges, fetches, mutation e instruções DDL com a cláusula ON CLUSTER:
```sql theme={null}
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START REPLICATION QUEUES
Permite iniciar tarefas de fetch em segundo plano a partir das filas de replicação armazenadas no Zookeeper para tabelas da família `ReplicatedMergeTree`. Os tipos possíveis de tarefas em segundo plano são - merges, fetches, mutation, instruções DDL com a cláusula 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
Interrompe a leitura de novas entradas do log de replicação para a fila de replicação em uma tabela `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
Cancela `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
Aguarde até que uma tabela `ReplicatedMergeTree` esteja sincronizada com outras réplicas em um cluster, mas por no máximo `receive_timeout` segundos.
```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]
```
Após executar esta instrução, `[db.]replicated_merge_tree_family_table_name` busca comandos do log replicado comum para sua própria fila de replicação, e então a consulta aguarda até que a réplica processe todos os comandos buscados. Há suporte para os seguintes modificadores:
* Com `IF EXISTS` (disponível desde a versão 25.6), a consulta não gerará erro se a tabela não existir. Isso é útil ao adicionar uma nova réplica a um cluster, quando ela já faz parte da configuração do cluster, mas ainda está em processo de criação e sincronização da tabela.
* Se um modificador `STRICT` for especificado, a consulta aguardará até que a fila de replicação fique vazia. A versão `STRICT` pode nunca ser concluída com sucesso se novas entradas continuarem aparecendo na fila de replicação.
* Se um modificador `LIGHTWEIGHT` for especificado, a consulta aguardará apenas o processamento das entradas `GET_PART`, `ATTACH_PART`, `DROP_RANGE`, `REPLACE_RANGE` e `DROP_PART`.
Além disso, o modificador LIGHTWEIGHT oferece suporte a uma cláusula opcional FROM 'srcReplicas', em que 'srcReplicas' é uma lista, separada por vírgulas, com nomes de réplicas de origem. Essa extensão permite uma sincronização mais direcionada, ao focar apenas nas tarefas de replicação originadas das réplicas de origem especificadas.
* Se um modificador `PULL` for especificado, a consulta extrai novas entradas da fila de replicação do ZooKeeper, mas não aguarda o processamento de nada.
### SYNC DATABASE REPLICA
Aguarda até que o [banco de dados replicado](/pt-BR/reference/engines/database-engines/replicated) especificado aplique todas as alterações de esquema presentes na fila DDL desse banco de dados.
**Sintaxe**
```sql theme={null}
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
```
### SYSTEM RESTART REPLICA
Permite reinicializar o estado da sessão do ZooKeeper para a tabela `ReplicatedMergeTree`, comparar o estado atual com o ZooKeeper como fonte da verdade e adicionar tarefas à fila do ZooKeeper, se necessário.
A inicialização da fila de replicação com base nos dados do ZooKeeper acontece da mesma forma que na instrução `ATTACH TABLE`. Por um curto período, a tabela ficará indisponível para qualquer operação.
```sql theme={null}
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
### SYSTEM RESTORE REPLICA
Restaura uma réplica se os dados \[possivelmente] ainda estiverem presentes, mas os metadados do ZooKeeper tiverem sido perdidos.
Funciona apenas em tabelas `ReplicatedMergeTree` somente leitura.
É possível executar a consulta após:
* Perda da raiz `/` do ZooKeeper.
* Perda do caminho de réplicas `/replicas`.
* Perda do caminho de uma réplica específica `/replicas/replica_name/`.
A réplica anexa as partes encontradas localmente e envia informações sobre elas ao ZooKeeper.
As partes presentes em uma réplica antes da perda dos metadados não são buscadas novamente de outras réplicas se não estiverem desatualizadas (ou seja, restaurar a réplica não significa baixar novamente todos os dados pela rede).
As partes em qualquer estado são movidas para a pasta `detached/`. As partes que estavam ativas antes da perda dos dados (confirmadas) são anexadas.
### SYSTEM RESTORE DATABASE REPLICA
Restaura uma réplica caso os dados \[possivelmente] ainda estejam presentes, mas os metadados do Zookeeper tenham sido perdidos.
**Sintaxe**
```sql theme={null}
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
```
**Exemplo**
```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) <- perda do nó raiz.
SYSTEM RESTORE DATABASE REPLICA repl_db;
```
**Sintaxe**
```sql theme={null}
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
```
Sintaxe alternativa:
```sql theme={null}
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
**Exemplo**
Criar uma tabela em vários servidores. Depois que os metadados da réplica no ZooKeeper são perdidos, a tabela será anexada em modo somente leitura, já que os metadados estão ausentes. A última consulta precisa ser executada em cada réplica.
```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) <- perda da raiz.
SYSTEM RESTART REPLICA test;
SYSTEM RESTORE REPLICA test;
```
Outra forma:
```sql theme={null}
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
```
### SYSTEM RESTART REPLICAS
Permite reinicializar o estado das sessões do Zookeeper para todas as tabelas `ReplicatedMergeTree`, comparando o estado atual com o Zookeeper como fonte da verdade e adicionando tarefas à fila do Zookeeper, se necessário
### SYSTEM CLEAR|DROP FILESYSTEM CACHE
Permite limpar o cache do sistema de arquivos.
```sql theme={null}
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
```
### SYSTEM SYNC FILE CACHE
É muito pesado e pode ser usado indevidamente.
Executa a syscall `sync`.
```sql theme={null}
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
```
### SYSTEM LOAD PRIMARY KEY
Carrega as chaves primárias para a tabela especificada ou para todas as tabelas.
```sql theme={null}
SYSTEM LOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM LOAD PRIMARY KEY
```
### SYSTEM UNLOAD PRIMARY KEY
Descarrega as chaves primárias da tabela especificada ou de todas as tabelas.
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY
```
## Gerenciando views materializadas atualizáveis
Comandos para controlar tarefas em segundo plano executadas por [views materializadas atualizáveis](/pt-BR/reference/statements/create/view#refreshable-materialized-view)
Fique de olho em [`system.view_refreshes`](/pt-BR/reference/system-tables/view_refreshes) ao usá-las.
### SYSTEM STOP \[REPLICATED] VIEW, STOP VIEWS
Desativa a atualização periódica da view especificada ou de todas as views atualizáveis. Se houver uma atualização em andamento, ela também será cancelada.
Se a view estiver em um banco de dados Replicated ou Shared, `STOP VIEW` afeta apenas a réplica atual, enquanto `STOP REPLICATED VIEW` afeta todas as réplicas.
O estado de parada não persiste após reinicializações do servidor. Após uma reinicialização, as views voltarão a seguir os agendamentos de atualização configurados.
Em bancos de dados Replicated ou Shared, `SYSTEM STOP VIEW` afeta apenas a réplica atual. Use `SYSTEM STOP REPLICATED VIEW` para interromper as atualizações em todas as réplicas.
```sql theme={null}
SYSTEM STOP VIEW [db.]name
```
```sql theme={null}
SYSTEM STOP VIEWS
```
### SYSTEM START \[REPLICATED] VIEW, START VIEWS
Ativa a atualização periódica da view especificada ou de todas as views atualizáveis. Nenhuma atualização imediata é disparada.
Se a view estiver em um banco de dados Replicated ou Shared, `START VIEW` desfaz o efeito de `STOP VIEW`, e `START REPLICATED VIEW` desfaz o efeito de `STOP REPLICATED VIEW`. `START VIEW` também desfaz o efeito de `PAUSE VIEW`.
```sql theme={null}
SYSTEM START VIEW [db.]name
```
```sql theme={null}
SYSTEM START VIEWS
```
### SYSTEM PAUSE VIEW, PAUSE VIEWS
Desativa a atualização periódica da view especificada ou de todas as views atualizáveis.
Ao contrário de `SYSTEM STOP VIEW`, `SYSTEM PAUSE VIEW` não interrompe uma atualização que já esteja em andamento: a atualização em execução pode terminar, e apenas as atualizações subsequentes são impedidas.
Reative com `SYSTEM START VIEW` ou `SYSTEM START VIEWS`.
O estado de pausa não persiste após reinicializações do servidor. Depois de uma reinicialização, as views retomarão seus intervalos de atualização configurados.
Em bancos de dados Replicated ou Shared, `SYSTEM PAUSE VIEW` afeta apenas a réplica atual.
```sql theme={null}
SYSTEM PAUSE VIEW [db.]name
```
```sql theme={null}
SYSTEM PAUSE VIEWS
```
### SYSTEM REFRESH VIEW
Executa uma atualização imediata, fora do agendamento, de uma determinada view.
```sql theme={null}
SYSTEM REFRESH VIEW [db.]name
```
### SYSTEM WAIT VIEW
Espera a atualização em execução ser concluída. Se nenhuma atualização estiver em execução, retorna imediatamente. Se a tentativa de atualização mais recente tiver falhado, retorna um erro.
Pode ser usado logo após criar uma nova view materializada atualizável (sem a palavra-chave EMPTY) para aguardar a conclusão da atualização inicial.
Se a view estiver em um banco de dados Replicated ou Shared, e a atualização estiver em execução em outra réplica, aguarda a conclusão dessa atualização.
```sql theme={null}
SYSTEM WAIT VIEW [db.]name
```
### SYSTEM CANCEL VIEW
Se houver uma atualização em andamento para a view especificada na réplica atual, interrompa-o e cancele-o. Caso contrário, não faça nada.
```sql theme={null}
SYSTEM CANCEL VIEW [db.]name
```
## SYSTEM FLUSH OBJECT STORAGE QUEUE
Bloqueia até que o arquivo especificado seja processado ou falhe permanentemente pela tabela [S3Queue](/pt-BR/reference/engines/table-engines/integrations/s3queue) ou [AzureQueue](/pt-BR/reference/engines/table-engines/integrations/azure-queue) informada. Retorna imediatamente se o arquivo já tiver sido processado. Gera um erro se o arquivo tiver falhado permanentemente (todas as tentativas esgotadas).
```sql theme={null}
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
```