Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

ajustes de sesión de distributed_cache_*

Estos ajustes están disponibles en system.settings y se generan automáticamente a partir del código fuente.

distributed_cache_alignment

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.70Se renombró distributed_cache_read_alignment

Solo tiene efecto en ClickHouse Cloud. Es una configuración para pruebas; no la cambie

distributed_cache_bypass_connection_pool

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
24.100Una opción de configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Permite omitir el pool de conexiones de caché distribuida

distributed_cache_client_id

Solo para ClickHouse Cloud
Historial de versiones
VersiónValor predeterminadoComentario
26.9Nueva configuración (solo para pruebas de CI) para sobrescribir el ID de client de caché distribuida por consulta.
26.8Nueva configuración (solo para pruebas de CI) para sobrescribir el ID de client de caché distribuida por consulta.

Solo tiene efecto en ClickHouse Cloud. Configuración utilizada únicamente para pruebas de CI: cuando no está vacía, sobrescribe el ID de client de caché distribuida configurado en el registro para las solicitudes de esta consulta. Permite que las pruebas distribuyan los datos entre un conjunto limitado de ID de client, manteniendo los mismos datos en el mismo ID de client. Requiere que ci_mode esté habilitado en la configuración del client de caché distribuida: cuando no lo está (el valor predeterminado, como en producción), una consulta que enruta una lectura o escritura a través de la caché distribuida falla con SUPPORT_IS_DISABLED en lugar de recurrir silenciosamente al ID de client configurado. Las consultas que nunca alcanzan la caché distribuida no se ven afectadas, por lo que el valor se ignora en ellas.

distributed_cache_connect_backoff_max_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
50
Historial de versiones
VersiónValor predeterminadoComentario
25.850Nuevo ajuste

Solo tiene efecto en ClickHouse Cloud. Número máximo de milisegundos de backoff para la creación de conexiones de caché distribuida.

distributed_cache_connect_backoff_min_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.80Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Número mínimo de milisegundos de espera entre reintentos al crear conexiones de caché distribuida.

distributed_cache_connect_max_tries

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
5
Historial de versiones
VersiónValor predeterminadoComentario
25.85Valor de configuración modificado
25.120Solo en Cloud
24.1020Una configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Número de intentos de conexión a caché distribuida en caso de error

distributed_cache_connect_timeout_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
50
Historial de versiones
VersiónValor predeterminadoComentario
25.1050Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera de la conexión al conectarse al servidor de caché distribuida.

distributed_cache_credentials_refresh_period_seconds

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
5
Historial de versiones
VersiónValor predeterminadoComentario
25.65Nueva configuración privada

Solo tiene efecto en ClickHouse Cloud. Período de actualización de las credenciales.

distributed_cache_data_packet_ack_window

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
5
Historial de versiones
VersiónValor predeterminadoComentario
24.105Una configuración de ClickHouse Cloud

Solo surte efecto en ClickHouse Cloud. Ventana para enviar ACK de la secuencia de DataPacket en una única solicitud de lectura de caché distribuida

distributed_cache_discard_connection_if_unread_data

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
24.111Nueva configuración
24.101Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Descarta la conexión si quedan datos sin leer.

distributed_cache_fetch_metrics_only_from_current_az

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
24.101Una configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Recupera métricas únicamente de la zona de disponibilidad actual en system.distributed_cache_metrics, system.distributed_cache_events

distributed_cache_file_cache_name

Solo para ClickHouse Cloud
Historial de versiones
VersiónValor predeterminadoComentario
26.1Nueva configuración.

Solo tiene efecto en ClickHouse Cloud. Configuración usada solo para pruebas de CI: nombre de la caché del sistema de archivos que se usará en caché distribuida.

distributed_cache_log_mode

Solo para ClickHouse Cloud
Tipo
DistributedCacheLogMode
Predeterminado
on_error
Historial de versiones
VersiónValor predeterminadoComentario
24.10on_errorUna configuración de ClickHouse Cloud

Solo surte efecto en ClickHouse Cloud. Modo de escritura en system.distributed_cache_log

distributed_cache_max_unacked_inflight_packets

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
24.1010Una configuración de ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Número máximo de paquetes en tránsito sin confirmar en una única solicitud de lectura del caché distribuida

distributed_cache_min_bytes_for_seek

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.10Nueva configuración privada.

Solo tiene efecto en ClickHouse Cloud. Número mínimo de bytes para realizar un seek en caché distribuida.

distributed_cache_min_inflight_bytes_to_discard_connection_on_seek

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
4194304
Historial de versiones
VersiónValor predeterminadoComentario
26.94194304Nueva configuración para descartar y volver a abrir una conexión de caché distribuida al realizar un reposicionamiento cuando, de otro modo, habría que descartar demasiados bytes en tránsito. El valor predeterminado es 4 MiB; 0 restaura el comportamiento anterior (reutilizar siempre la conexión mediante el ID del rango de lectura).
26.84194304Nueva configuración para descartar y volver a abrir una conexión de caché distribuida al realizar un reposicionamiento cuando, de otro modo, habría que descartar demasiados bytes en tránsito. El valor predeterminado es 4 MiB; 0 restaura el comportamiento anterior (reutilizar siempre la conexión mediante el ID del rango de lectura).
26.74194304Nueva configuración para descartar y volver a abrir una conexión de caché distribuida al realizar un reposicionamiento cuando, de otro modo, habría que descartar demasiados bytes en tránsito. El valor predeterminado es 4 MiB; 0 restaura el comportamiento anterior (reutilizar siempre la conexión mediante el ID del rango de lectura).

Solo tiene efecto en ClickHouse Cloud. Al reposicionarse desde la posición actual de un stream de caché distribuida abierto, si el número estimado de bytes en tránsito que habría que descartar para seguir reutilizando la conexión (mediante el mecanismo de ID del rango de lectura) supera este valor, descarte la conexión y abra una nueva. Esto evita tener que descartar una gran cantidad de datos no utilizados cuando los reposicionamientos son frecuentes. 0 deshabilita esta opción y reutiliza siempre la conexión.

distributed_cache_pool_behaviour_on_limit

Solo para ClickHouse Cloud
Tipo
DistributedCachePoolBehaviourOnLimit
Predeterminado
wait
Historial de versiones
VersiónValor predeterminadoComentario
25.1waitSolo en Cloud
24.10allocate_bypassing_poolUna configuración de ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Identifica el comportamiento de la conexión de caché distribuida cuando se alcanza el límite del grupo

distributed_cache_prefer_bigger_buffer_size

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
25.100Nueva configuración.

Solo tiene efecto en ClickHouse Cloud. Lo mismo que filesystem_cache_prefer_bigger_buffer_size, pero para caché distribuida.

distributed_cache_read_only_from_current_az

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.51Nuevo ajuste

Solo tiene efecto en ClickHouse Cloud. Permite leer solo desde la zona de disponibilidad actual. Si se desactiva, leerá desde todos los servidores de caché de todas las zonas de disponibilidad.

distributed_cache_read_request_max_tries

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
25.810Valor de la configuración cambiado
25.420Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Número de intentos para realizar una solicitud de lectura a caché distribuida si no tiene éxito

distributed_cache_receive_response_wait_milliseconds

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
60000
Historial de versiones
VersiónValor predeterminadoComentario
24.1060000Una configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera en milisegundos para recibir datos de una solicitud desde caché distribuida

distributed_cache_receive_timeout_milliseconds

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
10000
Historial de versiones
VersiónValor predeterminadoComentario
24.1010000Un ajuste para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera, en milisegundos, para recibir cualquier tipo de respuesta de la caché distribuida

Valor predeterminado en Cloud: 20000.

distributed_cache_receive_timeout_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
3000
Historial de versiones
VersiónValor predeterminadoComentario
25.103000Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para recibir datos desde el servidor de Distributed Cache, en milisegundos. Si no se recibe ningún byte durante este intervalo, se lanza una excepción.

distributed_cache_registry_show_certificate_and_signature

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
26.60Nueva opción de configuración para mostrar las columnas `certificate` y `signature` en `system.distributed_cache_registry`.

Solo tiene efecto en ClickHouse Cloud. Muestra las columnas certificate y signature en la tabla system.distributed_cache_registry. De forma predeterminada, estas columnas están vacías para mantener la salida compacta; habilita esta opción para inspeccionarlas.

distributed_cache_send_timeout_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
3000
Historial de versiones
VersiónValor predeterminadoComentario
25.103000Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera para enviar datos al servidor de caché distribuida, en milisegundos. Si un client necesita enviar datos pero no puede enviar ningún byte dentro de este intervalo, se lanza una excepción.

distributed_cache_tcp_keep_alive_timeout_ms

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
2900
Historial de versiones
VersiónValor predeterminadoComentario
25.102900Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Es el tiempo, en milisegundos, que la conexión con el servidor de Distributed Cache debe permanecer inactiva antes de que TCP comience a enviar sondas de keepalive.

distributed_cache_throw_on_error

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
0
Historial de versiones
VersiónValor predeterminadoComentario
24.100Una configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Vuelve a lanzar cualquier excepción que se produzca durante la comunicación con la caché distribuida o cualquier excepción recibida de la caché distribuida. En caso contrario, omite la caché distribuida si se produce un error.

distributed_cache_use_clients_cache_for_read

Solo para ClickHouse Cloud
Tipo
Bool
Predeterminado
1
Historial de versiones
VersiónValor predeterminadoComentario
25.121Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Usa la caché de los clientes para solicitudes de lectura.

distributed_cache_wait_connection_from_pool_milliseconds

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
100
Historial de versiones
VersiónValor predeterminadoComentario
24.10100Una configuración para ClickHouse Cloud

Solo tiene efecto en ClickHouse Cloud. Tiempo de espera, en milisegundos, para obtener una conexión del grupo de conexiones si distributed_cache_pool_behaviour_on_limit es wait

distributed_cache_write_request_max_tries

Solo para ClickHouse Cloud
Tipo
UInt64
Predeterminado
10
Historial de versiones
VersiónValor predeterminadoComentario
26.410Nueva configuración

Solo tiene efecto en ClickHouse Cloud. Número de intentos para realizar una solicitud de escritura en la caché distribuida si falla

Navigation