Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão distributed_cache_*

Estas configurações estão disponíveis em system.settings e são geradas automaticamente com base no código-fonte.

distributed_cache_alignment

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.70Renomeação de distributed_cache_read_alignment

Só tem efeito no ClickHouse Cloud. Uma configuração para fins de teste; não a altere

distributed_cache_bypass_connection_pool

Somente no ClickHouse Cloud
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.100Uma configuração para ClickHouse Cloud

Tem efeito apenas no ClickHouse Cloud. Permite ignorar o pool de conexões do distributed cache

distributed_cache_client_id

Somente no ClickHouse Cloud
Histórico de versões
VersãoValor padrãoComentário
26.9Nova configuração (somente para testes de CI) para substituir o ID do cliente do distributed cache por consulta.
26.8Nova configuração (somente para testes de CI) para substituir o ID do cliente do distributed cache por consulta.

Tem efeito apenas no ClickHouse Cloud. Configuração usada somente em testes de CI: quando não vazia, substitui o ID do cliente do distributed cache configurado no registro para as solicitações desta consulta. Permite que os testes distribuam os dados entre um conjunto limitado de IDs de cliente, mantendo os mesmos dados no mesmo ID de cliente. Exige que ci_mode esteja habilitado na configuração do cliente do distributed cache: caso contrário (o padrão, como em produção), uma consulta que encaminhe uma leitura ou gravação pelo distributed cache falhará com SUPPORT_IS_DISABLED, em vez de recorrer silenciosamente ao ID de cliente configurado. Consultas que nunca chegam ao distributed cache não são afetadas, portanto, o valor é ignorado nesses casos.

distributed_cache_connect_backoff_max_ms

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

Tem efeito apenas no ClickHouse Cloud. Número máximo de milissegundos de backoff para a criação de conexões com o distributed cache.

distributed_cache_connect_backoff_min_ms

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

Só tem efeito no ClickHouse Cloud. Valor mínimo, em milissegundos, de backoff para criar conexão com o cache distribuído.

distributed_cache_connect_max_tries

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
5
Histórico de versões
VersãoValor padrãoComentário
25.85Valor da configuração alterado
25.120Apenas Cloud
24.1020Uma configuração do ClickHouse Cloud

Tem efeito apenas no ClickHouse Cloud. Número de tentativas de conexão com o distributed cache em caso de falha

distributed_cache_connect_timeout_ms

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

Só tem efeito no ClickHouse Cloud. Tempo limite de conexão ao se conectar ao servidor do cache distribuído.

distributed_cache_credentials_refresh_period_seconds

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
5
Histórico de versões
VersãoValor padrãoComentário
25.65Nova configuração privada

Só tem efeito no ClickHouse Cloud. Período de atualização das credenciais.

distributed_cache_data_packet_ack_window

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
5
Histórico de versões
VersãoValor padrãoComentário
24.105Uma configuração para o ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Uma janela para o envio de ACK da sequência de DataPacket em uma única solicitação de leitura do distributed cache

distributed_cache_discard_connection_if_unread_data

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

Só tem efeito no ClickHouse Cloud. Descarta a conexão se houver dados não lidos.

distributed_cache_fetch_metrics_only_from_current_az

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

Tem efeito apenas no ClickHouse Cloud. Busca métricas apenas da zona de disponibilidade atual em system.distributed_cache_metrics, system.distributed_cache_events

distributed_cache_file_cache_name

Somente no ClickHouse Cloud
Histórico de versões
VersãoValor padrãoComentário
26.1Nova configuração.

Só tem efeito no ClickHouse Cloud. Uma configuração usada apenas em testes de CI: nome do cache do sistema de arquivos a ser usado no distributed cache.

distributed_cache_log_mode

Somente no ClickHouse Cloud
Tipo
DistributedCacheLogMode
Padrão
on_error
Histórico de versões
VersãoValor padrãoComentário
24.10on_errorUma configuração do ClickHouse Cloud

Tem efeito apenas no ClickHouse Cloud. Modo de gravação em system.distributed_cache_log

distributed_cache_max_unacked_inflight_packets

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
10
Histórico de versões
VersãoValor padrãoComentário
24.1010Uma configuração do ClickHouse Cloud

Tem efeito apenas no ClickHouse Cloud. Número máximo de pacotes em trânsito sem confirmação em uma única solicitação de leitura do distributed cache

distributed_cache_min_bytes_for_seek

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
25.10Nova configuração privada.

Só tem efeito no ClickHouse Cloud. Número mínimo de bytes para realizar seek no distributed cache.

distributed_cache_min_inflight_bytes_to_discard_connection_on_seek

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
4194304
Histórico de versões
VersãoValor padrãoComentário
26.94194304Nova configuração para descartar e reabrir uma conexão de distributed cache durante uma operação de seek quando muitos bytes em trânsito teriam de ser descartados. O padrão é 4 MiB; 0 restaura o comportamento anterior (sempre reutilizar a conexão por meio do ID do intervalo de leitura).
26.84194304Nova configuração para descartar e reabrir uma conexão de distributed cache durante uma operação de seek quando muitos bytes em trânsito teriam de ser descartados. O padrão é 4 MiB; 0 restaura o comportamento anterior (sempre reutilizar a conexão por meio do ID do intervalo de leitura).
26.74194304Nova configuração para descartar e reabrir uma conexão de distributed cache durante uma operação de seek quando muitos bytes em trânsito teriam de ser descartados. O padrão é 4 MiB; 0 restaura o comportamento anterior (sempre reutilizar a conexão por meio do ID do intervalo de leitura).

Só tem efeito no ClickHouse Cloud. Ao realizar uma operação de seek a partir da posição atual de um stream de distributed cache aberto, se a quantidade estimada de bytes em trânsito que teria de ser descartada para continuar reutilizando a conexão (por meio do mecanismo de ID do intervalo de leitura) exceder esse valor, descarte a conexão e abra uma nova. Isso evita drenar uma grande quantidade de dados não utilizados quando as operações de seek são frequentes. 0 desativa esse comportamento e sempre reutiliza a conexão.

distributed_cache_pool_behaviour_on_limit

Somente no ClickHouse Cloud
Tipo
DistributedCachePoolBehaviourOnLimit
Padrão
wait
Histórico de versões
VersãoValor padrãoComentário
25.1waitApenas no Cloud
24.10allocate_bypassing_poolUma configuração do ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Identifica o comportamento da conexão do cache distribuído quando o limite do pool é atingido

distributed_cache_prefer_bigger_buffer_size

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

Só tem efeito no ClickHouse Cloud. O mesmo que filesystem_cache_prefer_bigger_buffer_size, mas para o cache distribuído.

distributed_cache_read_only_from_current_az

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

Tem efeito apenas no ClickHouse Cloud. Permite ler apenas da zona de disponibilidade atual. Se desabilitada, fará a leitura de todos os servidores de cache em todas as zonas de disponibilidade.

distributed_cache_read_request_max_tries

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
10
Histórico de versões
VersãoValor padrãoComentário
25.810Valor da configuração alterado
25.420Nova configuração

Tem efeito apenas no ClickHouse Cloud. Número de tentativas para realizar uma solicitação de leitura ao distributed cache em caso de falha

distributed_cache_receive_response_wait_milliseconds

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
60000
Histórico de versões
VersãoValor padrãoComentário
24.1060000Uma configuração para ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Tempo de espera, em milissegundos, para receber os dados de uma solicitação do cache distribuído

distributed_cache_receive_timeout_milliseconds

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
10000
Histórico de versões
VersãoValor padrãoComentário
24.1010000Uma configuração do ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Tempo de espera, em milissegundos, para receber qualquer tipo de resposta do cache distribuído

Valor padrão no Cloud: 20000.

distributed_cache_receive_timeout_ms

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

Só tem efeito no ClickHouse Cloud. Tempo limite para receber dados do servidor do Distributed Cache, em milissegundos. Se nenhum byte for recebido nesse intervalo, uma exceção é lançada.

distributed_cache_registry_show_certificate_and_signature

Somente no ClickHouse Cloud
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.60Nova configuração para exibir as colunas `certificate` e `signature` em `system.distributed_cache_registry`.

Só tem efeito no ClickHouse Cloud. Exibe as colunas certificate e signature na tabela system.distributed_cache_registry. Por padrão, essas colunas ficam vazias para manter a saída compacta; habilite essa configuração para inspecioná-las.

distributed_cache_send_timeout_ms

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

Só tem efeito no ClickHouse Cloud. Tempo limite para enviar dados ao servidor de cache distribuído, em milissegundos. Se um cliente precisar enviar dados, mas não conseguir enviar nenhum byte nesse intervalo, uma exceção é lançada.

distributed_cache_tcp_keep_alive_timeout_ms

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

Só tem efeito no ClickHouse Cloud. Tempo, em milissegundos, que a conexão com o servidor do distributed cache precisa permanecer ociosa antes de o TCP começar a enviar sondas de keepalive.

distributed_cache_throw_on_error

Somente no ClickHouse Cloud
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.100Uma configuração do ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Relança a exceção ocorrida durante a comunicação com o distributed cache ou a exceção recebida do distributed cache. Caso contrário, o fallback é ignorar o distributed cache em caso de erro

distributed_cache_use_clients_cache_for_read

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

Só tem efeito no ClickHouse Cloud. Use o cache de clientes para requisições de leitura.

distributed_cache_wait_connection_from_pool_milliseconds

Somente no ClickHouse Cloud
Tipo
UInt64
Padrão
100
Histórico de versões
VersãoValor padrãoComentário
24.10100Uma configuração do ClickHouse Cloud

Só tem efeito no ClickHouse Cloud. Tempo de espera, em milissegundos, para obter uma conexão do pool de conexões se distributed_cache_pool_behaviour_on_limit for wait

distributed_cache_write_request_max_tries

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

Tem efeito apenas no ClickHouse Cloud. Número de tentativas para fazer uma solicitação de gravação do distributed cache em caso de insucesso

Navigation