Estas configurações estão disponíveis em system.settings e são geradas automaticamente com base no código-fonte.
distributed_cache_alignment
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.7 | 0 | Renomeaçã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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 0 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.9 | Nova configuração (somente para testes de CI) para substituir o ID do cliente do distributed cache por consulta. | |
| 26.8 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.8 | 50 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.8 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.8 | 5 | Valor da configuração alterado |
| 25.1 | 20 | Apenas Cloud |
| 24.10 | 20 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.10 | 50 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.6 | 5 | Nova configuração privada |
Só tem efeito no ClickHouse Cloud. Período de atualização das credenciais.
distributed_cache_data_packet_ack_window
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 5 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.11 | 1 | Nova configuração |
| 24.10 | 1 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 1 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.1 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | on_error | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 10 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.1 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.9 | 4194304 | Nova 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.8 | 4194304 | Nova 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.7 | 4194304 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.1 | wait | Apenas no Cloud |
| 24.10 | allocate_bypassing_pool | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.10 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.5 | 1 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.8 | 10 | Valor da configuração alterado |
| 25.4 | 20 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 60000 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 10000 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.10 | 3000 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.6 | 0 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.10 | 3000 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.10 | 2900 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 0 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 25.12 | 1 | Nova 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 24.10 | 100 | Uma 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
Histórico de versões
| Versão | Valor padrão | Comentário |
|---|---|---|
| 26.4 | 10 | Nova 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