SYSTEM RELOAD EMBEDDED DICTIONARIES
Recarga todos los diccionarios internos. De forma predeterminada, los diccionarios internos están deshabilitados. Siempre devuelveOk. independientemente del resultado de la actualización de los diccionarios internos.
SYSTEM RELOAD DICTIONARIES
La consultaSYSTEM RELOAD DICTIONARIES recarga los diccionarios con estado LOADED (consulte la columna status de system.dictionaries); es decir, los diccionarios que ya se habían cargado correctamente.
De forma predeterminada, los diccionarios se cargan de forma diferida (consulte dictionaries_lazy_load), por lo que, en lugar de cargarse automáticamente al inicio, se inicializan en el primer acceso, ya sea al usar la función dictGet o al ejecutar SELECT sobre tablas con ENGINE = Dictionary.
Sintaxis
SYSTEM RELOAD DICTIONARY
Recarga por completo un diccionariodictionary_name, independientemente del estado del diccionario (LOADED / NOT_LOADED / FAILED).
Siempre devuelve Ok., independientemente del resultado de la actualización del diccionario.
system.dictionaries.
SYSTEM UNLOAD DICTIONARY
Descarga un diccionariodictionary_name para liberar la memoria que ocupa, si el estado del diccionario es LOADED.
El diccionario se recarga de forma diferida cuando sea necesario de nuevo.
system.dictionaries.
SYSTEM UNLOAD DICTIONARIES
Laconsulta SYSTEM UNLOAD DICTIONARIES descarga de la memoria todos los diccionarios con estado LOADED (consulte la columna status de system.dictionaries); es decir, los diccionarios que se habían cargado correctamente con anterioridad.
SYSTEM RELOAD FUNCTIONS
Recarga todas las funciones ejecutables definidas por el usuario registradas, o una de ellas, desde un archivo de configuración. SintaxisSYSTEM RELOAD ASYNCHRONOUS METRICS
Vuelve a calcular todas las métricas asíncronas. Dado que las métricas asíncronas se actualizan periódicamente según la configuración asynchronous_metrics_update_period_s, por lo general no es necesario actualizarlas manualmente mediante esta sentencia.SYSTEM CLEAR|DROP DNS CACHE
Borra la caché DNS interna de ClickHouse. A veces (en versiones antiguas de ClickHouse) es necesario usar este comando al modificar la infraestructura (por ejemplo, al cambiar la dirección IP de otro servidor de ClickHouse o del servidor usado por los diccionarios). Para una gestión más práctica (automática) de la caché, consulte los parámetrosdisable_internal_dns_cache, dns_cache_max_entries, dns_cache_update_period.
SYSTEM CLEAR|DROP MARK CACHE
Limpia la caché de marcas.SYSTEM CLEAR|DROP PRIMARY INDEX CACHE
Borra la caché del índice primario, que almacena en memoria las claves primarias de las tablasMergeTree.
Su tamaño se configura con la opción de configuración a nivel de servidor primary_index_cache_size.
SYSTEM CLEAR|DROP ICEBERG METADATA CACHE
Limpia la caché de metadatos de Iceberg.SYSTEM CLEAR|DROP AVRO SCHEMA CACHE
Borra las cachés por URL de Confluent Schema Registry que utiliza el formatoAvroConfluent. Esto elimina tanto la caché de recuperación de esquemas (id → esquema) como la caché de registro de esquemas (subject + esquema → id), por lo que las lecturas y escrituras posteriores vuelven a recurrir al servidor del registro. Resulta útil cuando se eliminó o reescribió un esquema en el registro, o para verificar la idempotencia del registro en las pruebas.
SYSTEM DROP PARQUET METADATA CACHE
Vacía la caché de metadatos de Parquet.SYSTEM CLEAR|DROP PAIMON METADATA CACHE
Limpia la caché en memoria de los archivos de metadatos de Paimon procesados (listas de manifiestos y manifiestos).SYSTEM CLEAR|DROP POINT IN POLYGON CACHE
Borra la caché de polígonos constantes preprocesados que utiliza la funciónpointInPolygon. El límite de tamaño configurado (la configuración del servidor point_in_polygon_cache_size) no se modifica, por lo que la caché sigue aceptando entradas después. Para desactivar la caché, establece point_in_polygon_cache_size en 0.
SYSTEM CLEAR|DROP TEXT INDEX CACHES
Borra las cachés de tokens, cabecera y postings del índice de texto. Si desea borrar una de estas cachés individualmente, puede ejecutarSYSTEM CLEAR TEXT INDEX TOKENS CACHE,SYSTEM CLEAR TEXT INDEX HEADER CACHE, oSYSTEM CLEAR TEXT INDEX POSTINGS CACHE
SYSTEM CLEAR|DROP INDEX MARK CACHE
Limpia la caché de marcas de índice de los índices secundarios (de omisión de datos).SYSTEM CLEAR|DROP INDEX UNCOMPRESSED CACHE
Limpia la caché de bloques sin comprimir de los índices secundarios (de omisión de datos).SYSTEM CLEAR|DROP MMAP CACHE
Borra la caché de los archivos mapeados en memoria.SYSTEM CLEAR|DROP PAGE CACHE
Borra la caché de páginas en espacio de usuario, es decir, la propia caché en memoria de ClickHouse para los datos leídos del almacenamiento subyacente.SYSTEM CLEAR|DROP VECTOR SIMILARITY INDEX CACHE
Limpia la caché del índice de similitud vectorial.SYSTEM CLEAR|DROP CONNECTIONS CACHE
Borra la caché de los grupos de conexiones HTTP que se usan para las conexiones salientes.SYSTEM CLEAR|DROP S3 CLIENT CACHE
Borra la caché de los clients de S3.SYSTEM PREWARM MARK CACHE
Carga las marcas de una tabla en la caché de marcas. Las marcas de los índices secundarios también se cargan en la caché de marcas de índice.SYSTEM PREWARM PRIMARY INDEX CACHE
Carga los índices primarios de una tablaMergeTree en la caché de índice primario.
SYSTEM CLEAR|DROP DISK METADATA CACHE
Limpia la caché de metadatos del disco especificado.SYSTEM SYNC FILESYSTEM CACHE
Sincroniza el estado en memoria de la caché del sistema de archivos de ClickHouse con los archivos de caché realmente presentes en disco y devuelve elcache_name, la path y el size descargado de cada segmento de archivo en caché. Un nombre de caché opcional limita la operación a una sola caché.
SYSTEM CLEAR|DROP DISTRIBUTED CACHE
SYSTEM CLEAR|DROP DISTRIBUTED CACHE está disponible solo en ClickHouse Cloud.CONNECTIONS para eliminar únicamente las conexiones en caché a los servidores de la caché distribuida, o pase un identificador de servidor para actuar sobre un solo servidor.
SYSTEM DROP REPLICA
Las réplicas caídas de las tablasReplicatedMergeTree pueden eliminarse con la siguiente sintaxis:
ReplicatedMergeTree en ZooKeeper. Esto resulta útil cuando la réplica está inactiva y sus metadatos no pueden eliminarse de ZooKeeper mediante DROP TABLE porque esa tabla ya no existe. Solo eliminará la réplica inactiva/obsoleta y no puede eliminar la réplica local; para eso, use DROP TABLE. DROP REPLICA no elimina ninguna tabla ni quita ningún dato o metadato del disco.
La primera elimina los metadatos de la réplica 'replica_name' de la tabla database.table.
La segunda hace lo mismo para todas las tablas replicadas de la base de datos.
La tercera hace lo mismo para todas las tablas replicadas en el servidor local.
La cuarta es útil para eliminar los metadatos de una réplica inactiva cuando se eliminaron todas las demás réplicas de una tabla. Requiere que la ruta de la tabla se especifique explícitamente. Debe ser la misma ruta que se pasó como primer argumento del motor ReplicatedMergeTree al crear la tabla.
SYSTEM DROP DATABASE REPLICA
Las réplicas inactivas de las bases de datosReplicated pueden eliminarse con la siguiente sintaxis:
SYSTEM DROP REPLICA, pero elimina de ZooKeeper la ruta de la réplica de la base de datos Replicated cuando no hay ninguna base de datos en la que ejecutar DROP DATABASE. Tenga en cuenta que no elimina las réplicas de ReplicatedMergeTree (por lo que también podría necesitar SYSTEM DROP REPLICA). Los nombres del segmento y de la réplica son los que se especificaron en los argumentos del motor Replicated al crear la base de datos. Además, estos nombres pueden obtenerse de las columnas database_shard_name y database_replica_name de system.clusters. Si falta la cláusula FROM SHARD, replica_name debe ser un nombre de réplica completo con el formato shard_name|replica_name.
SYSTEM CLEAR|DROP UNCOMPRESSED CACHE
Borra la caché de datos sin comprimir. La caché de datos sin comprimir se habilita o deshabilita mediante la configuraciónuse_uncompressed_cache a nivel de consulta/USER/perfil.
Su tamaño puede configurarse mediante la configuración uncompressed_cache_size a nivel de servidor.
SYSTEM CLEAR|DROP CACHÉ DE EXPRESIONES COMPILADAS
Borra la caché de expresiones compiladas. La caché de expresiones compiladas se activa o desactiva con la configuracióncompile_expressions de nivel de consulta/usuario/perfil.
SYSTEM CLEAR|DROP QUERY CONDITION CACHE
Limpia la caché de condiciones de consulta.SYSTEM CLEAR|DROP CACHE DE ENCABEZADOS DE CIFRADO
Borra la caché de encabezados de cifrado. Esta caché almacena los encabezados de cifrado leídos al inicio de los archivos cifrados y la utiliza la ruta de lectura experimentaluse_reader_executor para evitar volver a leerlos; su tamaño se configura mediante la opción del servidor encryption_header_cache_size.
SYSTEM CLEAR|DROP QUERY CACHE
SYSTEM CLEAR|DROP FORMAT SCHEMA CACHE
Limpia la caché de los esquemas cargados desdeformat_schema_path.
Destinos admitidos:
- Protobuf: Elimina de la memoria las definiciones importadas de mensajes Protobuf.
- Files: Elimina los archivos de esquema en caché almacenados localmente en
format_schema_path, generados cuandoformat_schema_sourcese establece enquery. Nota: Si no se especifica ningún destino, se limpian ambas cachés.
SYSTEM FLUSH LOGS
Vuelca los mensajes de registro almacenados en búfer en las tablas del sistema, p. ej., system.query_log. Resulta útil sobre todo para la depuración, ya que la mayoría de las tablas del sistema tienen un intervalo de vaciado predeterminado de 7.5 segundos. Esto también crea las tablas del sistema aunque la cola de mensajes esté vacía.SYSTEM RELOAD CONFIG
Recarga la configuración de ClickHouse. Se utiliza cuando la configuración está almacenada en ZooKeeper. Tenga en cuenta queSYSTEM RELOAD CONFIG no recarga la configuración de USER almacenada en ZooKeeper; solo recarga la configuración de USER almacenada en users.xml. Para recargar toda la configuración de USER, use SYSTEM RELOAD USERS
SYSTEM RELOAD USERS
Recarga todos los almacenamientos de acceso, incluidos: users.xml, el almacenamiento de acceso en disco local y el almacenamiento de acceso replicado (en ZooKeeper).SYSTEM SHUTDOWN
Detiene ClickHouse de forma normal (comoservice clickhouse-server stop / kill {$pid_clickhouse-server})
SYSTEM KILL
Interrumpe el proceso de ClickHouse (comokill -9 {$ pid_clickhouse-server})
SYSTEM INSTRUMENT
Gestiona los puntos de instrumentación mediante la funcionalidad XRay de LLVM, disponible cuando ClickHouse se compila conENABLE_XRAY=1.
Esto permite depurar y generar perfiles en producción sin modificar el código fuente y con una sobrecarga mínima.
Cuando no se añade ningún punto de instrumentación, la penalización en el rendimiento es insignificante, ya que solo añade un salto adicional a una
dirección cercana en el prólogo y el epílogo de aquellas funciones que superan las 200 instrucciones.
SYSTEM INSTRUMENT ADD
Agrega un nuevo punto de instrumentación. Las funciones instrumentadas pueden inspeccionarse en la tabla del sistemasystem.instrumentation. Se puede agregar más de un manejador a la misma función, y se ejecutarán en el mismo orden en que se añadió la instrumentación.
Las funciones que se van a instrumentar pueden obtenerse de la tabla del sistema system.symbols.
Hay tres tipos diferentes de manejadores que se pueden agregar a las funciones:
Sintaxis
FUNCTION es cualquier función o subcadena de una función, como QueryMetricLog::startQuery, y el manejador es uno de los siguientes
LOG
Imprime el texto proporcionado como argumento y la traza de pila, ya sea enENTRY o EXIT de la función.
SLEEP
Espera una cantidad fija de segundos, ya sea enENTRY o en EXIT:
PERFIL
Mide el tiempo empleado entreENTRY y EXIT de una función.
El resultado del perfilado se almacena en system.trace_log y puede convertirse
en Chrome Event Trace Format.
SYSTEM INSTRUMENT REMOVE
Elimina un único punto de instrumentación con:ALL:
system.instrumentation.
Gestión de tablas distribuidas
ClickHouse puede gestionar tablas distribuidas. Cuando un usuario inserta datos en estas tablas, ClickHouse primero crea una cola con los datos que deben enviarse a los nodos del clúster y luego los envía de forma asíncrona. Puede gestionar el procesamiento de la cola con las consultasSTOP DISTRIBUTED SENDS, FLUSH DISTRIBUTED y START DISTRIBUTED SENDS. También puede insertar datos distribuidos de forma síncrona con la configuración distributed_foreground_insert.
SYSTEM STOP DISTRIBUTED SENDS
Desactiva la distribución de datos en segundo plano al insertar datos en tablas distribuidas.Si
prefer_localhost_replica está habilitado (de forma predeterminada), los datos se insertarán igualmente en el segmento local.SYSTEM FLUSH DISTRIBUTED
Fuerza a ClickHouse a enviar datos a los nodos del clúster de forma síncrona. Si algún nodo no está disponible, ClickHouse lanza una excepción y detiene la ejecución de la consulta. Puede volver a intentar la consulta hasta que se ejecute correctamente, lo que ocurrirá cuando todos los nodos vuelvan a estar en línea. También puede sobrescribir algunas configuraciones mediante la cláusulaSETTINGS; esto puede ser útil para evitar ciertas limitaciones temporales, como max_concurrent_queries_for_all_users o max_memory_usage.
Cada bloque pendiente se almacena en disco con la configuración de la consulta INSERT inicial, por eso a veces puede convenir sobrescribir esa configuración.
SYSTEM START DISTRIBUTED SENDS
Activa la distribución de datos en segundo plano al insertar datos en tablas distribuidas.SYSTEM STOP LISTEN
Cierra el socket y finaliza de forma ordenada las conexiones existentes al servidor en el puerto y con el protocolo especificados. Sin embargo, si la configuración del protocolo correspondiente no se especificó en la configuración de clickhouse-server, este comando no tendrá efecto.- Si se especifica el modificador
CUSTOM 'protocol', se detendrá el protocolo personalizado con el nombre indicado, definido en la sección de protocolos de la configuración del servidor. - Si se especifica el modificador
QUERIES ALL [EXCEPT .. [,..]], se detendrán todos los protocolos, salvo los especificados en la cláusulaEXCEPT. - Si se especifica el modificador
QUERIES DEFAULT [EXCEPT .. [,..]], se detendrán todos los protocolos predeterminados, salvo los especificados en la cláusulaEXCEPT. - Si se especifica el modificador
QUERIES CUSTOM [EXCEPT .. [,..]], se detendrán todos los protocolos personalizados, salvo los especificados en la cláusulaEXCEPT.
SYSTEM START LISTEN
Permite establecer nuevas conexiones en los protocolos especificados. Sin embargo, si el servidor del puerto y protocolo especificados no se detuvo mediante el comando SYSTEM STOP LISTEN, este comando no tendrá efecto.Gestión de tablas MergeTree
ClickHouse puede gestionar los procesos en segundo plano de las tablas MergeTree.SYSTEM STOP MERGES
Permite detener las fusiones en segundo plano de las tablas de la familia MergeTree:La operación
DETACH / ATTACH sobre la tabla iniciará las fusiones en segundo plano de esa tabla, incluso si antes se habían detenido las fusiones para todas las tablas MergeTree.SYSTEM START MERGES
Permite iniciar las fusiones en segundo plano para tablas de la familia MergeTree:SYSTEM STOP TTL MERGES
Permite detener la eliminación en segundo plano de datos antiguos según la expresión TTL en tablas de la familia MergeTree: DevuelveOk. incluso si la tabla no existe o no tiene un motor MergeTree. Devuelve un error cuando la base de datos no existe:
SYSTEM START TTL MERGES
Permite iniciar la eliminación en segundo plano de datos antiguos según la expresión TTL en tablas de la familia MergeTree: DevuelveOk. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM STOP MOVES
Permite detener los movimientos de datos en segundo plano según la expresión TTL de la tabla con la cláusula TO VOLUME o TO DISK para las tablas de la familia MergeTree: DevuelveOk. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM START MOVES
Permite iniciar el movimiento de datos en segundo plano de acuerdo con la expresión TTL de la tabla con la cláusula TO VOLUME y TO DISK para las tablas de la familia MergeTree: DevuelveOk. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM UNFREEZE
Elimina una copia de seguridad congelada con el nombre especificado de todos los discos. Consulta más información sobre cómo descongelar partes individuales en ALTER TABLE table_name UNFREEZE WITH NAMESYSTEM 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).Gestión de tablas ReplicatedMergeTree
ClickHouse puede gestionar los procesos en segundo plano relacionados con la replicación en las tablas ReplicatedMergeTree.SYSTEM STOP FETCHES
Permite detener las recuperaciones en segundo plano de las partes insertadas para las tablas de la familiaReplicatedMergeTree:
Siempre devuelve Ok., independientemente del motor de tabla e incluso si la tabla o la base de datos no existen.
SYSTEM START FETCHES
Permite iniciar las operaciones de recuperación en segundo plano de las partes insertadas para las tablas de la familiaReplicatedMergeTree:
Siempre devuelve Ok., independientemente del motor de la tabla, incluso si la tabla o la base de datos no existen.
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 familiaReplicatedMergeTree:
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 familiaReplicatedMergeTree:
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 familiaReplicatedMergeTree. Posibles tipos de tareas en segundo plano: merges, fetches, mutación y sentencias DDL con la cláusula ON CLUSTER:
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 familiaReplicatedMergeTree. Posibles tipos de tareas en segundo plano: merges, recuperación, mutación, sentencias DDL con la cláusula ON CLUSTER:
SYSTEM STOP PULLING REPLICATION LOG
Detiene la carga de nuevas entradas del log de replicación en la cola de replicación de una tablaReplicatedMergeTree.
SYSTEM START PULLING REPLICATION LOG
AnulaSYSTEM STOP PULLING REPLICATION LOG.
SYSTEM SYNC REPLICA
Espera hasta que una tablaReplicatedMergeTree se sincronice con otras réplicas de un clúster, pero no más de receive_timeout segundos.
[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ónSTRICTnunca 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 entradasGET_PART,ATTACH_PART,DROP_RANGE,REPLACE_RANGEyDROP_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 especificada aplique todos los cambios de esquema de la cola de DDL de esa base de datos. SintaxisSYSTEM RESTART REPLICA
Permite reinicializar el estado de la sesión de ZooKeeper para la tablaReplicatedMergeTree; 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.
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 tablasReplicatedMergeTree 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/.
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. SintaxisSYSTEM RESTART REPLICAS
Permite reinicializar el estado de las sesiones de ZooKeeper para todas las tablasReplicatedMergeTree; 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.SYSTEM SYNC FILE CACHE
Es demasiado costoso y puede prestarse a un uso indebido.
SYSTEM LOAD PRIMARY KEY
Carga las claves primarias de la tabla indicada o de todas las tablas.SYSTEM UNLOAD PRIMARY KEY
Descargue las claves primarias de la tabla especificada o de todas las tablas.Gestión de vistas materializadas actualizables
Comandos para controlar las tareas en segundo plano que realizan las vistas materializadas actualizables Supervisesystem.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.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.
SYSTEM PAUSE VIEW, PAUSE VIEWS
Deshabilita la actualización periódica de la vista especificada o de todas las vistas actualizables. A diferencia deSYSTEM 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.SYSTEM REFRESH VIEW
Activa una actualización inmediata, fuera de programación, de la vista indicada.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.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.Gestión de la actividad en segundo plano
Comandos independientes del motor para controlar la actividad en segundo plano de una tabla concreta o de todas esas tablas del servidor a la vez. Incluyen:- Vistas materializadas actualizables (la actualización periódica), y
- los motores de tabla de streaming que consumen continuamente desde una fuente externa: Kafka, RabbitMQ, NATS, S3Queue y AzureQueue.
SYSTEM ... VIEW correspondiente de Gestión de vistas materializadas actualizables, por lo que SYSTEM STOP [db.]name se comporta exactamente igual que SYSTEM STOP VIEW [db.]name, y así sucesivamente.
Las formas por tabla y con comodín difieren en el tratamiento de las tablas sin actividad en segundo plano. La forma por tabla (SYSTEM STOP [db.]table) genera un error si la tabla indicada no es ni un motor de streaming ni una vista materializada actualizable. La forma con comodín omite silenciosamente dichas tablas, por lo que siempre es seguro ejecutarla.
STOP y CANCEL interrumpen el consumo lo antes posible. En Kafka, RabbitMQ y NATS, detienen la lectura desde la fuente, pero no interrumpen un insert que ya haya comenzado: un bloque que ya se está escribiendo en las vistas materializadas termina y realiza el commit. S3Queue y AzureQueue leen e insertan en un único pipeline. Con la deduplicación habilitada (valor predeterminado), también se cancela el insert y los archivos se reprocesan más adelante. Con la deduplicación deshabilitada, el lote en curso termina y realiza el commit (como en los motores anteriores) para evitar duplicar filas. Los datos que se leyeron pero aún no se habían confirmado se consumen de nuevo más adelante, por lo que no se pierde nada, salvo en NATS básico (sin JetStream), que no puede volver a entregarlos y los descarta.
PAUSE no interrumpe un insert en curso, por lo que normalmente no provoca pérdidas. NATS básico es la excepción: al pausarlo, se detiene el consumo y se descartan los mensajes que ya había recibido pero aún no había insertado, ya que NATS básico no puede volver a entregarlos.
Ninguno de estos estados persiste tras reiniciar el servidor. Después de reiniciarlo, las vistas materializadas actualizables reanudan su programación configurada y los motores de streaming reanudan el consumo.
SYSTEM STOP
Detiene la actividad en segundo plano y la mantiene detenida: interrumpe lo que se está ejecutando y no ejecuta nada más hastaSYSTEM START. Equivale a PAUSE + CANCEL.
SYSTEM START
Reanuda la actividad tras unSYSTEM STOP o SYSTEM PAUSE. No se interrumpe ninguna actividad.
SYSTEM PAUSE
Impide que se inicie más actividad en segundo plano, pero deja que finalice primero lo que se esté ejecutando en ese momento.SYSTEM CANCEL
Interrumpe únicamente la actividad que se está ejecutando en ese momento, sin bloquear actividades futuras; la tabla continúa actualizándose o consumiendo según su programación. No hace nada si no hay ninguna actividad en curso.SYSTEM REFRESH
Ejecuta un ciclo adicional fuera de la programación. En una tabla de streaming, se ejecuta de inmediato y una única vez, incluso si la tabla está detenida o pausada. En una vista materializada actualizable, se comporta comoSYSTEM REFRESH VIEW: si la vista está detenida, la actualización queda pendiente y se ejecuta una vez que SYSTEM START la reanuda.
Privilegios
Cada comando requiere el privilegio del motor correspondiente:SYSTEM VIEWS para una vista materializada actualizable y SYSTEM STREAMING ENGINES para una tabla de streaming. Ambos son privilegios secundarios de SYSTEM BACKGROUND, por lo que conceder SYSTEM BACKGROUND permite controlar la actividad en segundo plano de todas esas tablas. Las variantes ALL BACKGROUND se aplican únicamente a las tablas que el usuario puede controlar y omiten silenciosamente las demás.
SYSTEM FLUSH OBJECT STORAGE QUEUE
Espera hasta que el archivo especificado haya sido procesado o haya fallado de forma permanente en la tabla S3Queue o AzureQueue 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).SYSTEM ENABLE|DISABLE FAILPOINT
Los failpoints son puntos con nombre dentro del código del servidor en los que se puede inyectar un fallo bajo demanda —un error, un retardo o una pausa del thread en ejecución— con fines de prueba. Se enumeran en la tablasystem.fail_points junto con su estado actual.
SYSTEM ENABLE FAILPOINT activa un único fail point; SYSTEM DISABLE FAILPOINT lo desactiva y reanuda cualquier thread bloqueado en él, y no hace nada si no estaba habilitado.
SYSTEM DISABLE ALL FAILPOINTS deshabilita todos los fail points de una vez y reanuda todos los threads bloqueados en alguno que admita pausas. No recibe ningún nombre y es idempotente, por lo que un entorno de pruebas puede usarlo para devolver el servidor a un estado que no inyecte nada sin necesidad de saber qué fail points habilitó la prueba anterior. En un build sin soporte para fail points, la sentencia se ejecuta correctamente y no hace nada.
SYSTEM WAIT FAILPOINT ... PAUSE se bloquea hasta que un thread se pausa en el fail point indicado que admita pausas (o hasta que el fail point se deshabilita); ... RESUME se bloquea hasta que el thread pausado se reanuda, y SYSTEM NOTIFY FAILPOINT reanuda los threads pausados sin deshabilitar el fail point.
Los fail points son un estado local del nodo, por lo que ninguna de estas sentencias admite ON CLUSTER. Todas ellas requieren el privilegio SYSTEM FAILPOINT.