Skip to main content
Essas configurações estão disponíveis em system.settings e são geradas automaticamente a partir da fonte.

​
group_by_overflow_mode

Define o que acontece quando o número de chaves únicas para agregação excede o limite:
  • throw: gera uma exceção
  • break: interrompe a execução da consulta e retorna o resultado parcial
  • any: continua a agregação para as chaves que entraram no conjunto, mas não adiciona novas chaves ao conjunto.
Usar o valor any permite executar uma aproximação de GROUP BY. A qualidade dessa aproximação depende da natureza estatística dos dados.

​
group_by_two_level_threshold

Número de chaves a partir do qual uma agregação em dois níveis é iniciada. 0 - o limiar não está definido.

​
group_by_two_level_threshold_bytes

A partir de qual tamanho, em bytes, do estado de agregação, passa-se a usar a agregação em dois níveis. 0 - o limiar não está definido. A agregação em dois níveis é usada quando pelo menos um dos limiares é atingido.

​
group_by_use_nulls

Altera a forma como a cláusula GROUP BY trata os tipos das chaves de agregação. Quando os especificadores ROLLUP, CUBE ou GROUPING SETS são usados, algumas chaves de agregação podem não ser usadas na produção de determinadas linhas de resultado. As colunas dessas chaves são preenchidas com o valor padrão ou com NULL nas linhas correspondentes, dependendo dessa configuração. Valores possíveis:
  • 0 — O valor padrão do tipo da chave de agregação é usado para preencher valores ausentes.
  • 1 — O ClickHouse executa GROUP BY da mesma forma que o padrão SQL define. Os tipos das chaves de agregação são convertidos para Nullable. As colunas das chaves de agregação correspondentes são preenchidas com NULL nas linhas em que elas não foram usadas.
Veja também:
Última modificação em 23 de julho de 2026