configurações de sessão query_plan_*

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

Ativa ou desativa uma otimização no nível do plano de consulta que, quando uma agregação final alimenta ORDER BY com as saídas da agregação usando LIMIT n e o plano comprova que a seleção por bucket é exata, materializa apenas os n melhores grupos de cada bucket de dois níveis nessa ordem durante a conversão final da agregação. O resultado é exato: um grupo que não está entre os n melhores de seu próprio bucket tem pelo menos n grupos à sua frente globalmente e, portanto, não pode estar entre os n melhores globais. Só tem efeito se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desativar
• 1 - Ativar

Ativa/desativa a otimização de agregação em ordem no nível do plano de consulta. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilitar
• 1 - Habilitar

Permite converter ANY JOIN em SEMI JOIN ou ANTI JOIN se o filtro após o JOIN sempre resultar em false para linhas com ou sem correspondência

Permite converter JOIN em uma subconsulta com IN se as colunas de saída estiverem associadas apenas à tabela da esquerda. Pode causar resultados incorretos com JOINs que não sejam ANY (por exemplo, JOINs ALL, que são o padrão).

Permite converter OUTER JOIN em INNER JOIN se o filtro após JOIN sempre excluir os valores padrão

Permite executar a filtragem de busca de texto completo usando apenas o índice de texto invertido no plano de consulta.

Exibe aliases internos (como __table1) em EXPLAIN PLAN em vez dos especificados na consulta original.

Habilita multithreading após a avaliação de funções de janela para permitir o processamento de streams em paralelo

Ativa ou desativa a otimização de consultas no nível do plano de consulta.

Valores possíveis:

• 0 - Desabilita todas as otimizações no nível do plano de consulta
• 1 - Habilita as otimizações no nível do plano de consulta (mas otimizações individuais ainda podem ser desabilitadas por meio de suas próprias configurações)

Ativa ou desativa uma otimização no nível do plano de consulta que move expressões para depois das etapas de ordenação. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilitado
• 1 - Habilitado

Ativa ou desativa uma otimização em nível do plano de consulta que empurra os filtros para baixo no plano de execução. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilita
• 1 - Habilita

Ativa ou desativa uma otimização no nível do plano de consulta que incorpora um filtro em colunas de elementos associadas a ARRAY JOIN à etapa ARRAY JOIN, filtrando os arrays no espaço dos elementos antes da expansão, para que os elementos filtrados nunca sejam expandidos ou replicados. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Aplica sharding ao JOIN se as chaves de junção contiverem um prefixo de PRIMARY KEY em ambas as tabelas. Compatível com os algoritmos hash, parallel_hash, full_sorting_merge e parallel_full_sorting_merge. Normalmente não acelera as consultas, mas pode reduzir o consumo de memória.

Define qual lado do join deve ser a tabela de build (também chamada de inner, aquela inserida na tabela hash em um hash join) no plano da consulta. Essa configuração é suportada apenas para a strictness ALL de join com a cláusula JOIN ON. Os valores possíveis são:

• 'auto': Deixa o planner decidir qual tabela usar como tabela de build.
• 'false': Nunca troca as tabelas (a tabela da direita é a tabela de build).
• 'true': Sempre troca as tabelas (a tabela da esquerda é a tabela de build).

Ativa ou desativa uma otimização no nível do plano de consulta que move ARRAY JOINs para cima no plano de execução. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desativado
• 1 - Ativado

Ativa ou desativa uma otimização no nível do plano de consulta que move subárvores maiores do plano de consulta para union, a fim de viabilizar outras otimizações. Só surte efeito se a configuração query_plan_enable_optimizations estiver em 1.

Valores possíveis:

• 0 - Desativado
• 1 - Ativado

Controla o valor máximo de limite que permite usar o plano de consulta na otimização de lazy indexing em JOIN. Se for zero, não haverá limite.

Controla o valor máximo de LIMIT que permite usar o plano de consulta para a otimização de materialização lazy. Se for zero, não há limite.

Controla o valor máximo do limite que permite avaliar o plano de consulta para a otimização TopK usando índice de salto minmax e filtragem dinâmica por limiar. Se for zero, não haverá limite.

Esta configuração também controla o comportamento de enable_group_by_top_k_optimization.

Limita o número total de otimizações aplicadas ao plano da consulta; consulte a configuração query_plan_enable_optimizations. É útil para evitar tempos de otimização muito longos em consultas complexas. Na consulta EXPLAIN PLAN, a aplicação de otimizações é interrompida após esse limite ser atingido, e o plano é retornado como está. Na execução normal de consultas, se o número real de otimizações exceder essa configuração, uma exceção é lançada.

Número máximo de linhas em um conjunto da cláusula IN para o qual o mecanismo de correspondência de projeção calcula e compara hashes de conteúdo ao decidir se dois conjuntos são iguais. Conjuntos maiores que esse valor são tratados como não correspondentes e ignoram a projeção. Zero desabilita totalmente a comparação por hash de conteúdo: a correspondência de projeção nunca é bem-sucedida para nós que contêm conjuntos da cláusula IN.

Usado pelo mecanismo de correspondência de projeção agregada (e por qualquer mecanismo de correspondência de projeção futuro que precise comparar conjuntos da cláusula IN). O cálculo do hash de conteúdo é O(N log N) em relação ao número de elementos do conjunto; essa configuração limita o custo incorrido durante o planejamento quando muitas cláusulas IN aparecem na consulta ou na projeção.

Comprimento máximo da descrição da etapa no EXPLAIN PLAN.

Permite mesclar expressões à etapa JOIN durante a otimização da reordenação de joins.

Ativa ou desativa uma otimização no nível do plano de consulta que mescla filtros consecutivos. Só entra em vigor se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desabilita
• 1 - Habilita

Permite incorporar o filtro à condição de JOIN e converter CROSS JOIN em INNER.

Permite mesclar filtros no plano de consulta.

Controla o número mínimo de colunas de payload do lado esquerdo necessário para ativar a otimização de lazy indexing em JOIN. 0 significa que a otimização está desativada.

Permite responder a SELECT count() ... WHERE <text search predicate> diretamente com base nas cardinalidades das listas de postagens do índice de texto, sem materializar as linhas correspondentes. Só tem efeito quando query_plan_direct_read_from_text_index está habilitada.

Especifica quais algoritmos de ordem de join devem ser testados durante a otimização do plano de consulta. Os seguintes algoritmos estão disponíveis:

• 'greedy' - algoritmo guloso básico - é rápido, mas pode não produzir a melhor ordem de join
• 'dpsize' - implementa o algoritmo DPsize, atualmente apenas para INNER JOINs - considera todas as ordens de join possíveis e encontra a mais otimizada, mas pode ser lento para consultas com muitas tabelas e predicados de junção.
• 'dpsub' - implementa o algoritmo DPsub, que oferece suporte a junções INNER e não INNER - considera todas as ordens de join possíveis e encontra a mais otimizada, mas pode ser lento para consultas com muitas tabelas e predicados de junção.
• 'dphyp' - implementa o algoritmo DPhyp (Programação Dinâmica via Particionamento de Hipergrafo), atualmente apenas para junções INNER - explora o mesmo espaço de busca que dpsize, mas enumera apenas pares de subgrafos conectados, o que gera menos junções intermediárias em grafos de junção esparsos, em troca de não considerar produtos cartesianos Vários algoritmos podem ser especificados como uma lista separada por vírgulas, por exemplo dphyp,greedy. Eles são testados na ordem informada; se um algoritmo não conseguir processar a consulta (por exemplo, devido a OUTER JOINs ou componentes desconectados), o próximo será usado como alternativa.

Otimiza a ordem de join dentro da mesma subconsulta. Atualmente, há suporte para isso apenas em casos muito limitados. O valor é o número máximo de tabelas a serem otimizadas.

Número máximo de planos parciais que o otimizador de ordem de join pode enumerar antes de interromper a busca e passar para o próximo algoritmo em query_plan_optimize_join_order_algorithm. Isso limita o tempo de otimização de forma determinística (independentemente do tempo decorrido) em grafos de join densos, como cliques ou estrelas, nos quais o espaço de busca cresce exponencialmente. Defina como 0 para desabilitar o limite. Não tem efeito sobre o query_plan_optimize_join_order_limit padrão, no qual a busca sempre permanece bem abaixo desse limite.

Quando diferente de zero, o otimizador da ordem de join usa cardinalidades e NDVs gerados aleatoriamente em vez de estatísticas reais. Quando definido como 1, uma semente aleatória é gerada; quando definido com um valor > 1, esse valor é usado diretamente como semente. Isso se destina a testes para identificar erros causados por diferentes ordenações de join.

Otimiza a leitura com FINAL no ReplacingMergeTree criando um conjunto de chaves primárias e usando-o na análise de índice.

Usar o plano de consulta na otimização de materialização lazy.

Use a otimização de materialização lazy para ler arquivos Parquet locais com a função de tabela file e o mecanismo de tabela File: em consultas ORDER BY ... LIMIT n, as colunas desnecessárias para ordenação e filtragem são lidas apenas para as n linhas que permanecem após o LIMIT. Só tem efeito se query_plan_optimize_lazy_materialization estiver habilitada.

Use a otimização de materialização lazy para ler arquivos Parquet do armazenamento de objetos (incluindo tabelas Iceberg): em consultas ORDER BY ... LIMIT n, as colunas desnecessárias para ordenação e filtragem são lidas apenas para as n linhas que permanecem após o LIMIT. Só tem efeito se query_plan_optimize_lazy_materialization estiver habilitada.

Permitir o push down do filtro para a expressão PREWHERE em armazenamentos compatíveis

Ativa ou desativa uma otimização no nível do plano de consulta que desloca os LIMITs para baixo no Plano de Execução. Só tem efeito se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desabilitar
• 1 - Habilitar

Ativa ou desativa uma otimização no nível do plano de consulta que desloca funções que reduzem o volume (length, lengthUTF8, empty, notEmpty) para baixo no plano de execução, abaixo das etapas Sorting e Filter. O resultado de tamanho fixo substitui o argumento amplo String / FixedString, de modo que ele não é mais transportado por essas etapas. A reescrita é aplicada somente quando a coluna de argumento não é necessária acima da etapa abaixo da qual ela é deslocada.

Só tem efeito se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desabilitar
• 1 - Habilitar

Ativa/desativa uma otimização no nível do plano de consulta para consultas ORDER BY ... LIMIT BY. Quando as colunas de LIMIT BY são um prefixo da cláusula ORDER BY, cada fluxo paralelo ordenado aplica LIMIT BY antes que os fluxos sejam mesclados em um só, reduzindo as linhas processadas pelo merge final e pelos estágios subsequentes do pipeline. Acelera consultas em que LIMIT BY descarta uma grande fração das linhas.

Só surte efeito se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desabilitado
• 1 - Habilitado

Ativa ou desativa a otimização de leitura em ordem no nível do plano de consulta. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desativa
• 1 - Ativa

Mantém a leitura em ordem da tabela à esquerda em operações JOIN, que pode ser aproveitada por etapas subsequentes.

Ativa ou desativa uma otimização no nível do plano de consulta que remove etapas DISTINCT redundantes. Só entra em vigor se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilitar
• 1 - Habilitar

Ativa ou desativa uma otimização no nível do plano de consulta que remove etapas de ordenação redundantes, por exemplo, em subconsultas. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desativar
• 1 - Ativar

Ativa ou desativa uma otimização no nível do plano de consulta que tenta remover colunas não utilizadas (tanto de entrada quanto de saída) das etapas do plano de consulta. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilitar
• 1 - Habilitar

Aliases: optimize_read_in_window_order

Ativa/desativa uma otimização no nível do plano de consulta que usa a ordenação do armazenamento ao ordenar funções de janela. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desativar
• 1 - Ativar

Aplica curto-circuito a um JOIN cuja condição ON é reduzida a uma constante falsa, substituindo por uma fonte vazia cada lado de entrada que não pode contribuir com uma linha (ambos os lados para INNER/CROSS/SEMI e o lado não preservado para LEFT/RIGHT), para que o lado que não contribui não seja lido. Aplica-se ao analyzer (enable_analyzer = 1) e a planos não distribuídos.

Ativa ou desativa uma otimização no nível do plano de consulta que divide filtros em expressões. Só tem efeito se a configuração query_plan_enable_optimizations estiver definida como 1.

Valores possíveis:

• 0 - Desativar
• 1 - Ativar

Permite adicionar uma indicação (predicado adicional) ao filtro criado a partir do índice de texto invertido no plano de consulta.

Ativa uma otimização no nível do plano de consulta que propaga ORDER BY ... LIMIT n para antes de um join quando a chave de ordenação faz referência apenas a colunas do lado preservado pelo join (LEFT/RIGHT). Isso limita quantas linhas a entrada do lado preservado precisa produzir antes do join. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desabilita
• 1 - Habilita

Ativa ou desativa uma otimização no nível do plano de consulta que tenta usar o índice de similaridade vetorial. Só tem efeito se a configuração query_plan_enable_optimizations for 1.

Valores possíveis:

• 0 - Desativar
• 1 - Ativar