Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão use_skip_indexes_*

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

use_skip_indexes

Tipo
Bool
Padrão
1

Usa data skipping indexes durante a execução de consultas.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.

use_skip_indexes_for_disjunctions

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

Avalia filtros WHERE com condições mistas de AND e OR usando skip indexes. Exemplo: WHERE A = 5 AND (B = 5 OR C = 5). Se essa opção estiver desabilitada, os skip indexes ainda serão usados para avaliar condições WHERE, mas elas devem conter apenas cláusulas combinadas com AND.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.

use_skip_indexes_for_top_k

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.51Habilita o uso de data skipping indexes para filtragem TopK por padrão
25.120Nova configuração.

Habilita o uso de data skipping indexes para filtragem TopK.

Quando habilitada, se existir um índice minmax na coluna da consulta ORDER BY <column> LIMIT n, o otimizador tentará usar o índice minmax para ignorar grânulos que não sejam relevantes para o resultado final. Isso pode reduzir a latência da consulta.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.

use_skip_indexes_if_final

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.61Mudança no valor padrão da configuração

Controla se os skip indexes são usados ao executar uma consulta com o modificador FINAL.

Os skip indexes podem excluir linhas (grânulos) que contêm os dados mais recentes, o que pode levar a resultados incorretos em uma consulta com o modificador FINAL. Quando essa configuração está habilitada, os skip indexes são aplicados mesmo com o modificador FINAL, o que pode melhorar o desempenho. Os resultados corretos ainda dependem da configuração use_skip_indexes_if_final_exact_mode, que é habilitada por padrão e examina as partes adicionais que se sobrepõem aos intervalos retornados pelo skip index. O risco de ignorar atualizações recentes aplica-se apenas se essa configuração estiver desabilitada.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.

use_skip_indexes_if_final_exact_mode

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.61Alteração no valor padrão da configuração
25.50Esta configuração foi introduzida para ajudar a consulta FINAL a retornar resultados corretos com skip indexes

Controla se os grânulos retornados por um skip index são expandidos em partes mais recentes para garantir resultados corretos ao executar uma consulta com o modificador FINAL.

O uso de skip indexes pode excluir linhas (grânulos) que contêm os dados mais recentes, o que pode levar a resultados incorretos. Esta configuração pode garantir o retorno de resultados corretos ao examinar partes mais recentes que se sobrepõem aos intervalos retornados pelo skip index. Esta configuração deve ser desabilitada apenas se resultados aproximados com base na consulta ao skip index forem aceitáveis para uma aplicação.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.

use_skip_indexes_on_data_read

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.21O text index agora é GA
26.10Habilitado por padrão
25.90Nova configuração

Habilita o uso de data skipping indexes durante a leitura de dados.

Quando habilitado, esses índices são avaliados dinamicamente no momento em que cada grânulo de dados é lido, em vez de serem analisados antecipadamente antes do início da execução da consulta. Isso pode reduzir a latência inicial da consulta.

Valores possíveis:

  • 0 — Desabilitado.
  • 1 — Habilitado.
Navigation