configurações de sessão use_*

Essas configurações estão disponíveis em system.settings e são autogeradas a partir do código-fonte.

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.

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 o fuso horário do cliente para interpretar valores de string do tipo DateTime, em vez de usar o fuso horário do servidor.

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}]].

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).

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:

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.

Habilita o uso de estatísticas de tabela hash coletadas para estimar a cardinalidade durante a reordenação de junções

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.

Quando habilitada, o ClickHouse detectará o particionamento no estilo Hive no caminho (/name=value/) em motores de tabela do tipo arquivo File/S3/URL/HDFS/AzureBlobStorage 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 _.

Aplica, nos próprios pools de leitura MergeTree, índices avaliados no momento da leitura de dados: intervalos de marcas totalmente filtrados por skip indexes (consulte use_skip_indexes_on_data_read) ou pelo índice de projeção (consulte optimize_use_projection_filtering) são descartados antes da criação de uma tarefa de leitura, em vez de serem ignorados grânulo a grânulo durante a leitura.

No pool de leitura com pré-busca, os intervalos descartados nunca são pré-carregados, mas os limites das tarefas e a admissão para pré-busca por filesystem_prefetch_max_memory_usage / filesystem_prefetches_limit ainda são definidos antes da filtragem. Portanto, com filtros altamente seletivos, as tarefas restantes podem ser menores que o tamanho de tarefa pretendido, e a admissão pode ser conservadora.

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.

Quando habilitada, o nome toTime refere-se à função toTime legada, que converte uma data com hora em uma determinada data fixa, preservando a hora. Caso contrário, o nome refere-se à nova função toTime, que converte valores de diferentes tipos para o tipo Time.

A função legada também fica sempre acessível como toTimeWithFixedDate, independentemente desta configuração. Enquanto esta configuração estiver habilitada, use CAST(x AS Time) ou x::Time para converter para o tipo Time.

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.

Quando ativado, o formato Parquet pode usar o cache de metadados do Parquet.

Valores possíveis:

• 0 - Desabilitado
• 1 - Habilitado

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.

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.

Usa bitmap roaring para exclusões posicionais do Iceberg.

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).

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.

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

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 (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.

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