Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão de filesystem_cache_*

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.111Nova configuração para controlar downloads em segundo plano no cache do sistema de arquivos por consulta.

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

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.110Nova configuração

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

Somente no ClickHouse Cloud
Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.111Nova configuração

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

Somente no ClickHouse Cloud
Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.111Nova configuração

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

Tipo
UInt64
Padrão
137438953472

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

filesystem_cache_name

Histórico de versões
VersãoValor padrãoComentário
24.10Nome do cache do sistema de arquivos a ser usado para motores de tabela sem estado ou lagos de dados

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.111Nova configuração

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

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
24.31000Tempo de espera para obter o bloqueio do cache para reserva de espaço no cache do sistema de arquivos

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

Tipo
UInt64
Padrão
20

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

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.111Renomeação da configuração skip_download_if_exceeds_query_cache_limit

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

filesystem_cache_verbose_logging

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração que controla as mensagens de log de nível TEST emitidas a cada recarga do buffer de leitura do cache do sistema de arquivos, que antes eram emitidas incondicionalmente assim que o nível de log permitia.

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

Tipo
UInt64
Padrão
1000
Histórico de versões
VersãoValor padrãoComentário
26.81000Nova configuração para limitar por quanto tempo uma leitura aguarda um segmento de arquivo ser baixado para o cache do sistema de arquivos por uma consulta concorrente; em caso de timeout, a leitura ignora o cache em vez de aguardar indefinidamente. O valor anterior, 60000, corresponde ao comportamento antigo (um ciclo completo de espera de 60 s no downloader).

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.

Navigation