```
### SYSTEM WAIT LOADING PARTS
Espere hasta que se hayan cargado todas las partes de datos de una tabla que se cargan asincrónicamente (partes de datos obsoletas).
```sql theme={null}
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
```
## Gestión de tablas ReplicatedMergeTree
ClickHouse puede gestionar los procesos en segundo plano relacionados con la replicación en las tablas [ReplicatedMergeTree](/es/reference/engines/table-engines/mergetree-family/replication).
### SYSTEM STOP FETCHES
Permite detener las recuperaciones en segundo plano de las partes insertadas para las tablas de la familia `ReplicatedMergeTree`:
Siempre devuelve `Ok.`, independientemente del motor de tabla e incluso si la tabla o la base de datos no existen.
```sql theme={null}
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM START FETCHES
Permite iniciar las operaciones de recuperación en segundo plano de las partes insertadas para las tablas de la familia `ReplicatedMergeTree`:
Siempre devuelve `Ok.`, independientemente del motor de la tabla, incluso si la tabla o la base de datos no existen.
```sql theme={null}
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATED SENDS
Permite detener los envíos en segundo plano a otras réplicas del clúster de las nuevas partes insertadas en tablas de la familia `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 en segundo plano el envío a otras réplicas del clúster de las nuevas partes insertadas en tablas de la familia `ReplicatedMergeTree`:
```sql theme={null}
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
```
### SYSTEM STOP REPLICATION QUEUES
Permite detener las tareas en segundo plano de recuperación de las colas de replicación almacenadas en ZooKeeper para tablas de la familia `ReplicatedMergeTree`. Posibles tipos de tareas en segundo plano: merges, fetches, mutación y sentencias DDL con la 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 tareas de recuperación en segundo plano desde las colas de replicación almacenadas en ZooKeeper para las tablas de la familia `ReplicatedMergeTree`. Posibles tipos de tareas en segundo plano: merges, recuperación, mutación, sentencias DDL con la 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
Detiene la carga de nuevas entradas del log de replicación en la cola de replicación de una tabla `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
Anula `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
Espera hasta que una tabla `ReplicatedMergeTree` se sincronice con otras réplicas de un clúster, pero no más de `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]
```
Después de ejecutar esta sentencia, `[db.]replicated_merge_tree_family_table_name` recupera comandos del log replicado común y los incorpora a su propia cola de replicación; luego, la consulta espera hasta que la réplica procese todos los comandos recuperados. Se admiten los siguientes modificadores:
* Con `IF EXISTS` (disponible desde la versión 25.6), la consulta no devolverá ningún error si la tabla no existe. Esto resulta útil al añadir una nueva réplica a un clúster, cuando ya forma parte de la configuración del clúster pero aún está en proceso de crear y sincronizar la tabla.
* Si se especificó un modificador `STRICT`, la consulta espera a que la cola de replicación quede vacía. Es posible que la versión `STRICT` nunca llegue a completarse si siguen apareciendo nuevas entradas en la cola de replicación.
* Si se especificó un modificador `LIGHTWEIGHT`, la consulta espera únicamente a que se procesen las entradas `GET_PART`, `ATTACH_PART`, `DROP_RANGE`, `REPLACE_RANGE` y `DROP_PART`.
Además, el modificador LIGHTWEIGHT admite una cláusula opcional FROM 'srcReplicas', donde 'srcReplicas' es una lista de nombres de réplicas de origen separada por comas. Esta extensión permite una sincronización más específica al centrarse solo en las tareas de replicación procedentes de las réplicas de origen indicadas.
* Si se especificó un modificador `PULL`, la consulta extrae nuevas entradas de la cola de replicación desde ZooKeeper, pero no espera a que se procese nada.
### SYNC DATABASE REPLICA
Espera hasta que la [base de datos replicada](/es/reference/engines/database-engines/replicated) especificada aplique todos los cambios de esquema de la cola de DDL de esa base de datos.
**Sintaxis**
```sql theme={null}
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
```
### SYSTEM RESTART REPLICA
Permite reinicializar el estado de la sesión de ZooKeeper para la tabla `ReplicatedMergeTree`; compara el estado actual con ZooKeeper como fuente de referencia y añade tareas a la cola de ZooKeeper si es necesario.
La inicialización de la cola de replicación a partir de los datos de ZooKeeper se realiza del mismo modo que con la sentencia `ATTACH TABLE`. Durante un breve período, la tabla no estará disponible para ninguna operación.
```sql theme={null}
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
### SYSTEM RESTORE REPLICA
Restaura una réplica si \[posiblemente] los datos están presentes, pero se han perdido los metadatos de ZooKeeper.
Funciona solo en tablas `ReplicatedMergeTree` en modo de solo lectura.
La consulta puede ejecutarse después de:
* La pérdida de la raíz `/` de ZooKeeper.
* La pérdida de la ruta de réplicas `/replicas`.
* La pérdida de la ruta de una réplica individual `/replicas/replica_name/`.
La réplica adjunta las partes encontradas localmente y envía información sobre ellas a ZooKeeper.
Las partes presentes en una réplica antes de la pérdida de metadatos no se vuelven a obtener de otras réplicas si no están desactualizadas (por lo que la restauración de la réplica no implica volver a descargar todos los datos a través de la red).
Las partes en todos los estados se mueven a la carpeta `detached/`. Las partes activas antes de la pérdida de datos (committed) se adjuntan.
### SYSTEM RESTORE DATABASE REPLICA
Restaura una réplica si es posible que los datos sigan presentes, pero se han perdido los metadatos de ZooKeeper.
**Sintaxis**
```sql theme={null}
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
```
**Ejemplo**
```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) <- pérdida de raíz.
SYSTEM RESTORE DATABASE REPLICA repl_db;
```
**Sintaxis**
```sql theme={null}
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
```
Sintaxis alternativa:
```sql theme={null}
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
```
**Ejemplo**
Creación de una tabla en varios servidores. Si se pierden los metadatos de la réplica en ZooKeeper, la tabla quedará adjunta en modo de solo lectura porque faltan los metadatos. La última consulta debe ejecutarse en 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) <- pérdida de raíz.
SYSTEM RESTART REPLICA test;
SYSTEM RESTORE REPLICA test;
```
Otra forma:
```sql theme={null}
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
```
### SYSTEM RESTART REPLICAS
Permite reinicializar el estado de las sesiones de ZooKeeper para todas las tablas `ReplicatedMergeTree`; compara el estado actual con ZooKeeper como fuente de verdad y añade tareas a la cola de ZooKeeper si es necesario
### SYSTEM CLEAR|DROP FILESYSTEM CACHE
Permite vaciar la caché del sistema de archivos.
```sql theme={null}
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
```
### SYSTEM SYNC FILE CACHE
Es demasiado costoso y puede prestarse a un uso indebido.
Realizará la llamada al sistema sync.
```sql theme={null}
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
```
### SYSTEM LOAD PRIMARY KEY
Carga las claves primarias de la tabla indicada o de todas las tablas.
```sql theme={null}
SYSTEM LOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM LOAD PRIMARY KEY
```
### SYSTEM UNLOAD PRIMARY KEY
Descargue las claves primarias de la tabla especificada o de todas las tablas.
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY [db.]name
```
```sql theme={null}
SYSTEM UNLOAD PRIMARY KEY
```
## Gestión de vistas materializadas actualizables
Comandos para controlar las tareas en segundo plano que realizan las [vistas materializadas actualizables](/es/reference/statements/create/view#refreshable-materialized-view)
Supervise [`system.view_refreshes`](/es/reference/system-tables/view_refreshes) mientras las utiliza.
### SYSTEM STOP \[REPLICATED] VIEW, STOP VIEWS
Deshabilita la actualización periódica de la vista indicada o de todas las vistas actualizables. Si hay una actualización en curso, también la cancela.
Si la vista está en una base de datos Replicated o Shared, `STOP VIEW` solo afecta a la réplica actual, mientras que `STOP REPLICATED VIEW` afecta a todas las réplicas.
El estado de detención no persiste tras reiniciar el servidor. Después de un reinicio, las vistas reanudarán sus programas de actualización configurados.
En las bases de datos Replicated o Shared, `SYSTEM STOP VIEW` solo afecta a la réplica actual. Usa `SYSTEM STOP REPLICATED VIEW` para detener las actualizaciones en todas las réplicas.
```sql theme={null}
SYSTEM STOP VIEW [db.]name
```
```sql theme={null}
SYSTEM STOP VIEWS
```
### SYSTEM START \[REPLICATED] VIEW, START VIEWS
Habilita la actualización periódica de la vista indicada o de todas las vistas actualizables. No se activa ninguna actualización inmediata.
Si la vista está en una base de datos Replicated o Shared, `START VIEW` revierte el efecto de `STOP VIEW` y `START REPLICATED VIEW` revierte el efecto de `STOP REPLICATED VIEW`. `START VIEW` también revierte el efecto de `PAUSE VIEW`.
```sql theme={null}
SYSTEM START VIEW [db.]name
```
```sql theme={null}
SYSTEM START VIEWS
```
### SYSTEM PAUSE VIEW, PAUSE VIEWS
Deshabilita la actualización periódica de la vista especificada o de todas las vistas actualizables.
A diferencia de `SYSTEM STOP VIEW`, `SYSTEM PAUSE VIEW` no interrumpe una actualización que ya esté en curso: deja que la actualización en ejecución termine y solo impide las actualizaciones posteriores.
Para revertirlo, use `SYSTEM START VIEW` o `SYSTEM START VIEWS`.
El estado de pausa no se mantiene entre reinicios del servidor. Después de reiniciar, las vistas reanudarán la programación de actualización configurada.
En bases de datos Replicated o Shared, `SYSTEM PAUSE VIEW` solo afecta a la réplica actual.
```sql theme={null}
SYSTEM PAUSE VIEW [db.]name
```
```sql theme={null}
SYSTEM PAUSE VIEWS
```
### SYSTEM REFRESH VIEW
Activa una actualización inmediata, fuera de programación, de la vista indicada.
```sql theme={null}
SYSTEM REFRESH VIEW [db.]name
```
### SYSTEM WAIT VIEW
Espera a que finalice la actualización en curso. Si no hay ninguna actualización en curso, devuelve el resultado inmediatamente. Si el último intento de actualización falló, devuelve un error.
Se puede usar justo después de crear una nueva vista materializada actualizable (sin la palabra clave EMPTY) para esperar a que finalice la actualización inicial.
Si la vista está en una base de datos Replicated o Shared y la actualización se está ejecutando en otra réplica, espera a que finalice esa actualización.
```sql theme={null}
SYSTEM WAIT VIEW [db.]name
```
### SYSTEM CANCEL VIEW
Si hay una actualización en curso de la vista especificada en la réplica actual, se interrumpe y se cancela. En caso contrario, no hace nada.
```sql theme={null}
SYSTEM CANCEL VIEW [db.]name
```
## SYSTEM FLUSH OBJECT STORAGE QUEUE
Espera hasta que el archivo especificado haya sido procesado o haya fallado de forma permanente en la tabla [S3Queue](/es/reference/engines/table-engines/integrations/s3queue) o [AzureQueue](/es/reference/engines/table-engines/integrations/azure-queue) indicada. Devuelve inmediatamente si el archivo ya se había procesado. Genera un error si el archivo ha fallado de forma permanente (se agotaron todos los reintentos).
```sql theme={null}
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
```