Skip to main content
Essas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

filesystem_cache_allow_background_download

Permite que o cache do sistema de arquivos enfileire downloads em segundo plano para dados lidos do armazenamento remoto. Desative esta opção para manter os downloads em primeiro plano para a consulta/sessão atual.

filesystem_cache_boundary_alignment

Alinhamento da fronteira do cache do sistema de arquivos. Esta configuração se aplica apenas a leituras que não são feitas em disco (por exemplo, ao cache de motores de tabela remotos / funções de tabela, mas não à configuração de armazenamento de tabelas MergeTree). O valor 0 significa que não há alinhamento.

filesystem_cache_enable_background_download_during_fetch

Só tem efeito no ClickHouse Cloud. Tempo de espera para obter o bloqueio do cache para reserva de espaço no cache do sistema de arquivos

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

Tem efeito apenas no ClickHouse Cloud. Tempo de espera para obter o bloqueio do cache para reserva de espaço no cache do sistema de arquivos

filesystem_cache_max_download_size

Tamanho máximo do cache do sistema de arquivos remoto que pode ser baixado por uma única consulta

filesystem_cache_name

Nome do cache do sistema de arquivos a ser usado para motores de tabela sem estado ou lagos de dados

filesystem_cache_prefer_bigger_buffer_size

Dá preferência a um tamanho de buffer maior quando o cache do sistema de arquivos está habilitado, para evitar gravar pequenos segmentos de arquivo, o que prejudica o desempenho do cache. Por outro lado, habilitar essa configuração pode aumentar o uso de memória.

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

Tempo de espera para obter o bloqueio do cache para reserva de espaço no cache do sistema de arquivos

filesystem_cache_segments_batch_size

Limite para o tamanho de um único lote de segmentos de arquivo que um buffer de leitura pode solicitar ao cache. Um valor muito baixo levará a solicitações excessivas ao cache; um valor muito alto pode tornar mais lenta a evicção do cache

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

Aliases: skip_download_if_exceeds_query_cache Ignora o download do sistema de arquivos remoto caso exceda o tamanho do cache de consultas

filesystem_cache_verbose_logging

Emite mensagens de log de nível TEST para cada recarga de buffer do cache do sistema de arquivos (estado da leitura, tamanho restante a ler, bytes lidos). Apenas para depuração: as mensagens são formatadas uma vez por leitura; portanto, habilitar essa opção em uma consulta que realiza muitas pequenas leituras em cache adiciona uma grande sobrecarga de logging. As mensagens só são visíveis quando o nível de log é test (consulte send_logs_level).

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

Tempo máximo de espera por um segmento de arquivo que está sendo baixado para o cache do sistema de arquivos por uma consulta concorrente. Quando o timeout é atingido, a leitura ignora o cache do sistema de arquivos para esse intervalo e lê diretamente do armazenamento remoto, enquanto o download concorrente continua a preencher o cache. O valor 0 significa não esperar: ignore imediatamente o cache se o intervalo necessário ainda não tiver sido baixado. Reduzir esse valor limita a latência de cauda das leituras com acerto de cache que, caso contrário, aguardariam o ritmo de download de outra consulta, ao custo de solicitações adicionais ao armazenamento remoto.
Última modificação em 14 de agosto de 2026