SYSTEM RELOAD EMBEDDED DICTIONARIES
Ok. independientemente del resultado de la actualización de los diccionarios internos.
SYSTEM RELOAD DICTIONARIES
SYSTEM 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 DICTIONARIES [ON CLUSTER cluster_name]
dictionary_name, independientemente del estado del diccionario (LOADED / NOT_LOADED / FAILED).
Siempre devuelve Ok., independientemente del resultado de la actualización del diccionario.
SYSTEM RELOAD DICTIONARY [ON CLUSTER cluster_name] dictionary_name
system.dictionaries.
SELECT name, status FROM system.dictionaries;
Esta sentencia y SYSTEM RELOAD MODEL simplemente descargan los modelos de CatBoost de clickhouse-library-bridge. La función catboostEvaluate()
carga un modelo en el primer acceso si todavía no está cargado.
SYSTEM RELOAD MODELS [ON CLUSTER cluster_name]
model_path.
Sintaxis
SYSTEM RELOAD MODEL [ON CLUSTER cluster_name] <model_path>
SYSTEM RELOAD FUNCTIONS [ON CLUSTER cluster_name]
SYSTEM RELOAD FUNCTION [ON CLUSTER cluster_name] function_name
SYSTEM RELOAD ASYNCHRONOUS METRICS
SYSTEM RELOAD ASYNCHRONOUS METRICS [ON CLUSTER cluster_name]
SYSTEM CLEAR|DROP DNS CACHE
disable_internal_dns_cache, dns_cache_max_entries, dns_cache_update_period.
SYSTEM CLEAR|DROP MARK CACHE
SYSTEM CLEAR|DROP AVRO SCHEMA CACHE
AvroConfluent. 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.
Vacía la caché de metadatos de Parquet.
SYSTEM CLEAR|DROP TEXT INDEX CACHES
SYSTEM CLEAR TEXT INDEX HEADER CACHE,SYSTEM CLEAR TEXT INDEX DICTIONARY CACHE, oSYSTEM CLEAR TEXT INDEX POSTINGS CACHE
Las réplicas caídas de las tablas ReplicatedMergeTree pueden eliminarse con la siguiente sintaxis:
SYSTEM DROP REPLICA 'replica_name' FROM TABLE database.table;
SYSTEM DROP REPLICA 'replica_name' FROM DATABASE database;
SYSTEM DROP REPLICA 'replica_name';
SYSTEM DROP REPLICA 'replica_name' FROM ZKPATH '/path/to/table/in/zk';
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
Replicated pueden eliminarse con la siguiente sintaxis:
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'] FROM DATABASE database;
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'];
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'] FROM ZKPATH '/path/to/table/in/zk';
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
use_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
compile_expressions de nivel de consulta/usuario/perfil.
SYSTEM CLEAR|DROP QUERY CONDITION CACHE
SYSTEM CLEAR|DROP QUERY CACHE
SYSTEM CLEAR QUERY CACHE;
SYSTEM CLEAR QUERY CACHE TAG '<tag>'
format_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 cuando format_schema_source se establece en query.
Nota: Si no se especifica ningún destino, se limpian ambas cachés.
SYSTEM CLEAR|DROP FORMAT SCHEMA CACHE [FOR Protobuf/Files]
SYSTEM FLUSH LOGS [ON CLUSTER cluster_name] [log_name|[database.table]] [, ...]
SYSTEM FLUSH LOGS query_log, system.query_views_log;
SYSTEM 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 CONFIG [ON CLUSTER cluster_name]
SYSTEM RELOAD USERS [ON CLUSTER cluster_name]
service clickhouse-server stop / kill {$pid_clickhouse-server})
Interrumpe el proceso de ClickHouse (como kill -9 {$ pid_clickhouse-server})
Gestiona los puntos de instrumentación mediante la funcionalidad XRay de LLVM, disponible cuando ClickHouse se compila con ENABLE_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.
Agrega un nuevo punto de instrumentación. Las funciones instrumentadas pueden inspeccionarse en la tabla del sistema system.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
SYSTEM INSTRUMENT ADD FUNCTION HANDLER [PARAMETERS]
FUNCTION es cualquier función o subcadena de una función, como QueryMetricLog::startQuery, y el manejador es uno de los siguientes
Imprime el texto proporcionado como argumento y la traza de pila, ya sea en ENTRY o EXIT de la función.
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' LOG ENTRY 'this is a log printed at entry'
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' LOG EXIT 'this is a log printed at exit'
ENTRY o en EXIT:
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0.5
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0 1
ENTRY 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 ADD 'QueryMetricLog::startQuery' PROFILE
SYSTEM INSTRUMENT REMOVE ID
ALL:
SYSTEM INSTRUMENT REMOVE ALL
SYSTEM INSTRUMENT REMOVE (SELECT id FROM system.instrumentation WHERE handler = 'log')
SYSTEM INSTRUMENT REMOVE 'QueryMetricLog::startQuery'
system.instrumentation.
Gestión de tablas distribuidas
STOP 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
SYSTEM STOP DISTRIBUTED SENDS [db.]<distributed_table_name> [ON CLUSTER cluster_name]
Si prefer_localhost_replica está habilitado (de forma predeterminada), los datos se insertarán igualmente en el segmento local. SETTINGS; esto puede ser útil para evitar ciertas limitaciones temporales, como max_concurrent_queries_for_all_users o max_memory_usage.
SYSTEM FLUSH DISTRIBUTED [db.]<distributed_table_name> [ON CLUSTER cluster_name] [SETTINGS ...]
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
SYSTEM START DISTRIBUTED SENDS [db.]<distributed_table_name> [ON CLUSTER cluster_name]
SYSTEM STOP LISTEN [ON CLUSTER cluster_name] [QUERIES ALL | QUERIES DEFAULT | QUERIES CUSTOM | TCP | TCP WITH PROXY | TCP SECURE | HTTP | HTTPS | MYSQL | GRPC | POSTGRESQL | PROMETHEUS | CUSTOM 'protocol']
- 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áusula EXCEPT.
- Si se especifica el modificador
QUERIES DEFAULT [EXCEPT .. [,..]], se detendrán todos los protocolos predeterminados, salvo los especificados en la cláusula EXCEPT.
- Si se especifica el modificador
QUERIES CUSTOM [EXCEPT .. [,..]], se detendrán todos los protocolos personalizados, salvo los especificados en la cláusula EXCEPT.
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.
SYSTEM START LISTEN [ON CLUSTER cluster_name] [QUERIES ALL | QUERIES DEFAULT | QUERIES CUSTOM | TCP | TCP WITH PROXY | TCP SECURE | HTTP | HTTPS | MYSQL | GRPC | POSTGRESQL | PROMETHEUS | CUSTOM 'protocol']
Gestión de tablas MergeTree
SYSTEM STOP MERGES [ON CLUSTER cluster_name] [ON VOLUME <volume_name> | [db.]merge_tree_family_table_name]
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 [ON CLUSTER cluster_name] [ON VOLUME <volume_name> | [db.]merge_tree_family_table_name]
Ok. incluso si la tabla no existe o no tiene un motor MergeTree. Devuelve un error cuando la base de datos no existe:
SYSTEM STOP TTL MERGES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM START TTL MERGES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM STOP MOVES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok. incluso si la tabla no existe. Devuelve un error cuando la base de datos no existe:
SYSTEM START MOVES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
SYSTEM UNFREEZE WITH NAME <backup_name>
SYSTEM WAIT LOADING PARTS
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
Gestión de tablas ReplicatedMergeTree
ReplicatedMergeTree:
Siempre devuelve Ok., independientemente del motor de tabla e incluso si la tabla o la base de datos no existen.
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
ReplicatedMergeTree:
Siempre devuelve Ok., independientemente del motor de la tabla, incluso si la tabla o la base de datos no existen.
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP REPLICATED SENDS
ReplicatedMergeTree:
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM START REPLICATED SENDS
ReplicatedMergeTree:
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP REPLICATION QUEUES
ReplicatedMergeTree. Posibles tipos de tareas en segundo plano: merges, fetches, mutación y sentencias DDL con la cláusula ON CLUSTER:
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM START REPLICATION QUEUES
ReplicatedMergeTree. Posibles tipos de tareas en segundo plano: merges, recuperación, mutación, sentencias DDL con la cláusula ON CLUSTER:
SYSTEM START REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP PULLING REPLICATION LOG
ReplicatedMergeTree.
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.
SYSTEM START PULLING REPLICATION LOG [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
ReplicatedMergeTree se sincronice con otras réplicas de un clúster, pero no más de receive_timeout segundos.
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 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.
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.
Sintaxis
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
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.
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
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
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
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;
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
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;
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
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
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
Es demasiado costoso y puede prestarse a un uso indebido.
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
SYSTEM LOAD PRIMARY KEY [db.]name
SYSTEM UNLOAD PRIMARY KEY
SYSTEM UNLOAD PRIMARY KEY [db.]name
SYSTEM UNLOAD PRIMARY KEY
Gestión de vistas materializadas actualizables
system.view_refreshes mientras las utiliza.
SYSTEM STOP [REPLICATED] VIEW, STOP VIEWS
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 STOP VIEW [db.]name
SYSTEM START [REPLICATED] VIEW, START VIEWS
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 START VIEW [db.]name
SYSTEM PAUSE VIEW, PAUSE VIEWS
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.
SYSTEM PAUSE VIEW [db.]name
SYSTEM REFRESH VIEW [db.]name
SYSTEM WAIT VIEW [db.]name
SYSTEM CANCEL VIEW [db.]name
SYSTEM FLUSH OBJECT STORAGE QUEUE
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
