> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# configurações de sessão use_*
> Configurações de sessão do ClickHouse no grupo use_* gerado.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Tipo
{type}
Padrão
{default_value}
{changeable_without_restart &&
Pode ser alterado sem reiniciar
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const ExperimentalBadge = () => {
return ;
};
Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são autogeradas a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## use\_async\_executor\_for\_materialized\_views
Usa execução assíncrona e potencialmente multithread da consulta da visão materializada, o que pode acelerar o processamento das visões durante o INSERT, mas também pode consumir mais memória.
## use\_cache\_for\_count\_from\_files
Habilita o armazenamento em cache do número de linhas durante a contagem em arquivos nas funções de tabela `file`/`s3`/`url`/`hdfs`/`azureBlobStorage`.
Habilitado por padrão.
## use\_client\_time\_zone
Use o fuso horário do cliente para interpretar valores de string do tipo DateTime, em vez de usar o fuso horário do servidor.
## use\_compact\_format\_in\_distributed\_parts\_names
Usa formato compacto para armazenar blocos para INSERT em segundo plano (`distributed_foreground_insert`) em tabelas com engine `Distributed`.
Valores possíveis:
* 0 — Usa o formato de diretório `user[:password]@host:port#default_database`.
* 1 — Usa o formato de diretório `[shard{shard_index}[_replica{replica_index}]]`.
- com `use_compact_format_in_distributed_parts_names=0`, alterações na definição do cluster não serão aplicadas ao INSERT em segundo plano.
- com `use_compact_format_in_distributed_parts_names=1`, alterar a ordem dos nós na definição do cluster mudará o `shard_index`/`replica_index`, então fique atento.
## use\_concurrency\_control
Respeita o controle de concorrência do servidor (consulte as configurações globais do servidor `concurrent_threads_soft_limit_num` e `concurrent_threads_soft_limit_ratio_to_cores`). Se estiver desabilitado, permite usar um número maior de threads mesmo que o servidor esteja sobrecarregado (não recomendado para uso normal e necessário principalmente para testes).
## use\_constant\_folding\_in\_index\_analysis
Substitua constantes no nível da partição no predicado de filtro ao analisar, por parte, a chave primária e os skip indexes.
Quando a chave de partição aparece no filtro junto com colunas da chave primária ou de skip index, isso permite que a análise de índices incorpore o valor da partição separadamente em cada parte. Isso é mais útil para filtros disjuntivos cujos ramos visam partições diferentes. Por exemplo, com `PARTITION BY a` e `ORDER BY b`:
```sql theme={null}
SELECT * FROM t WHERE (a = 1 AND b >= 1) OR (a = 2 AND b > 10) OR (a = 3 AND b > 10)
```
Para a parte da partição `a = 1`, a condição é simplificada para `b >= 1`, enquanto, para as partições `a = 2` e `a = 3`, ela é simplificada para `b > 10`, de modo que cada parte seja analisada com o predicado que de fato se aplica a ela.
Valores possíveis:
* 0 — Desativado.
* 1 — Ativado.
## use\_hash\_table\_stats\_for\_join\_reordering
Habilita o uso de estatísticas de tabela hash coletadas para estimar a cardinalidade durante a reordenação de junções
## use\_hedged\_requests
Ativa a lógica de hedged requests para consultas remotas. Ela permite estabelecer várias conexões com diferentes réplicas para a consulta.
Uma nova conexão é iniciada caso a(s) conexão(ões) existente(s) com a(s) réplica(s) não tenha(m) sido estabelecida(s) dentro de `hedged_connection_timeout`
ou nenhum dado tenha sido recebido dentro de `receive_data_timeout`. A consulta usa a primeira conexão que envia um pacote Progress não vazio (ou um pacote Data, se `allow_changing_replica_until_first_data_packet`);
as outras conexões são canceladas. Há suporte a consultas com `max_parallel_replicas > 1`.
Ativado por padrão.
Valor padrão no Cloud: `0`.
## use\_hive\_partitioning
Quando habilitada, o ClickHouse detectará o particionamento no estilo Hive no caminho (`/name=value/`) em motores de tabela do tipo arquivo [File](/docs/pt-BR/reference/functions/table-functions/file#hive-style-partitioning)/[S3](/docs/pt-BR/reference/functions/table-functions/s3#hive-style-partitioning)/[URL](/docs/pt-BR/reference/functions/table-functions/url#hive-style-partitioning)/[HDFS](/docs/pt-BR/reference/functions/table-functions/hdfs#hive-style-partitioning)/[AzureBlobStorage](/docs/pt-BR/reference/functions/table-functions/azureBlobStorage#hive-style-partitioning) e permitirá usar colunas de partição como colunas virtuais na consulta. Essas colunas virtuais terão os mesmos nomes do caminho particionado, mas começarão com `_`.
## use\_join\_disjunctions\_push\_down
Habilita o pushdown das partes das condições de JOIN conectadas por OR para os lados de entrada correspondentes ("pushdown parcial").
Isso permite que os motores de armazenamento apliquem filtros mais cedo, o que pode reduzir a quantidade de dados lidos.
A otimização preserva a semântica e é aplicada apenas quando cada ramo OR de nível superior contribui com pelo menos um
predicado determinístico para o lado de destino.
## use\_legacy\_to\_time
Quando habilitada, permite usar a função `toTime` legada, que converte uma data com hora em uma determinada data fixa, preservando a hora.
Caso contrário, usa a nova função `toTime`, que converte diferentes tipos de dados para o tipo `Time`.
A função legada antiga também fica sempre acessível como `toTimeWithFixedDate`.
## use\_lightweight\_primary\_key\_index\_analysis
Otimiza a análise do índice da chave primária para tabelas `MergeTree` com chaves primárias longas.
Quando habilitada, o tempo de execução da análise do índice depende principalmente da complexidade do filtro da consulta (das colunas-chave que ela realmente usa), e não do comprimento da chave primária — portanto, estender a chave de ordenação adiciona uma sobrecarga insignificante à análise do índice para consultas que filtram apenas algumas de suas colunas.
Valores possíveis:
* 0 — Desabilitada. Todas as colunas da chave primária são processadas durante a análise do índice.
* 1 — Habilitada.
## use\_parquet\_metadata\_cache
Quando ativado, o formato Parquet pode usar o cache de metadados do Parquet.
Valores possíveis:
* 0 - Desabilitado
* 1 - Habilitado
## use\_primary\_key
Usa a chave primária para podar grânulos durante a execução de consultas em tabelas MergeTree.
Valores possíveis:
* 0 — Desabilitado.
* 1 — Habilitado.
## use\_reader\_executor
Experimental. Direciona leituras pelo novo pipeline `ReaderExecutor` em vez da matryoshka legada de buffers de leitura. Recorre ao caminho legado para configurações que o executor ainda não suporta.
## use\_roaring\_bitmap\_iceberg\_positional\_deletes
Usa bitmap roaring para exclusões posicionais do Iceberg.
## use\_streaming\_marks\_compression
Ao carregar marcas para partes MergeTree, comprima-as em sua representação em memória, um bloco por vez (streaming), em vez de primeiro materializar todo o array simples de marcas. Isso reduz significativamente o uso máximo de memória durante o carregamento de marcas para partes compactas com muitos subfluxos (por exemplo, tabelas com colunas JSON e `write_marks_for_substreams_in_compact_parts` habilitado).
## use\_strict\_insert\_block\_limits
Quando ativada, aplica estritamente os limites mínimo e máximo do tamanho do bloco de inserção.
Um bloco é emitido quando:
* Limiares mínimos (AND): Ambos min\_insert\_block\_size\_rows AND min\_insert\_block\_size\_bytes são atingidos.
* Limiares máximos (OR): max\_insert\_block\_size\_rows OR max\_insert\_block\_size\_bytes é atingido.
Quando desativada, um bloco é emitido quando:
* Limiares mínimos (OR): min\_insert\_block\_size\_rows OR min\_insert\_block\_size\_bytes é atingido.
**Nota**: Se as configurações máximas forem menores que as configurações mínimas, os limites máximos têm precedência e os blocos serão emitidos antes que os limiares mínimos sejam atingidos.
**Nota**: Essa configuração é desativada automaticamente para async inserts, porque async inserts anexam tokens de desduplicação por entrada que são incompatíveis com a divisão de blocos necessária para aplicar limites estritos.
Desativada por padrão.
## use\_structure\_from\_insertion\_table\_in\_table\_functions
Usa a estrutura da tabela de inserção em vez da inferência de esquema com base nos dados. Valores possíveis: 0 - desabilitado, 1 - habilitado, 2 - automático
## use\_uncompressed\_cache
Define se deve usar um cache de blocos não comprimidos. Aceita 0 ou 1. O padrão é 0 (desabilitado).
Usar o cache não comprimido (apenas para tabelas da família MergeTree) pode reduzir significativamente a latência e aumentar a taxa de transferência ao trabalhar com um grande número de consultas curtas. Habilite essa configuração para usuários que enviam requisições curtas com frequência. Observe também o parâmetro de configuração [uncompressed\_cache\_size](/docs/pt-BR/reference/settings/server-settings/settings#uncompressed_cache_size) (definido apenas no arquivo de configuração) – o tamanho dos blocos do cache não comprimido. Por padrão, ele é de 8 GiB. O cache não comprimido é preenchido conforme necessário, e os dados menos usados são excluídos automaticamente.
Para consultas que leem pelo menos um volume de dados razoavelmente grande (um milhão de linhas ou mais), o cache não comprimido é desabilitado automaticamente para economizar espaço para consultas realmente pequenas. Isso significa que você pode manter a configuração `use_uncompressed_cache` sempre definida como 1.
## use\_with\_fill\_by\_sorting\_prefix
As colunas com WITH FILL que são precedidas por outras colunas na cláusula ORDER BY formam o prefixo de ordenação. As linhas com valores diferentes no prefixo de ordenação são preenchidas independentemente