> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# configurações de sessão use_statistics_*

> Configurações de sessão do ClickHouse no grupo use_statistics_* gerado.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["Versão", "Valor padrão", "Comentário"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        Histórico de versões
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Essas configurações estão disponíveis em [system.settings](/pt-BR/reference/system-tables/settings) e são geradas automaticamente com base no [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<h2 id="use_statistics">
  use\_statistics
</h2>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "1"},{"label": "Ativa esta otimização por padrão."}]}]} />

/// preferido em vez de 'allow\_statistics\_optimize' por consistência com 'use\_primary\_key' e 'use\_skip\_indexes'
Permite usar estatísticas para otimizar consultas

<h2 id="use_statistics_cache">
  use\_statistics\_cache
</h2>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "1"},{"label": "Habilitar cache de estatísticas"}]}, {"id": "row-2","items": [{"label": "25.11"},{"label": "0"},{"label": "Nova configuração"}]}]} />

Use o cache de estatísticas em uma consulta para evitar a sobrecarga do carregamento das estatísticas de todas as partes

<h2 id="use_statistics_for_min_max_aggregation">
  use\_statistics\_for\_min\_max\_aggregation
</h2>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "1"},{"label": "Nova configuração para responder às agregações `min`, `max` e `count` sem `GROUP BY` e sem filtros a partir das estatísticas de colunas por parte, nas partes que as têm materializadas, lendo apenas as partes restantes. previous_value=false, de modo que a `compatibility` com versões anteriores à 26.9 mantém a otimização desabilitada e restaura o plano preexistente."}]}]} />

Responde às agregações `min`, `max` e `count` a partir das estatísticas de colunas por parte, em vez de ler os dados.

Quando habilitada, uma consulta no formato `SELECT min(column), max(column), count() FROM table` sem `GROUP BY` e sem filtros
é respondida a partir das estatísticas de colunas (por exemplo, estatísticas MinMax; veja a configuração de MergeTree `auto_statistics_types`)
nas partes de dados que as têm materializadas, e apenas as partes restantes são lidas.

Valores possíveis:

* 0 — Desabilitado.
* 1 — Habilitado.

<h2 id="use_statistics_for_part_pruning">
  use\_statistics\_for\_part\_pruning
</h2>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1"},{"label": "Nova configuração para usar estatísticas na eliminação de partes durante a execução da consulta."}]}]} />

Usa estatísticas para filtrar partes durante a execução da consulta.

Quando habilitada, a eliminação de partes em consultas SELECT usa estatísticas de colunas (por exemplo, estatísticas MinMax) para descartar partes que não podem conter dados correspondentes antes que qualquer dado seja lido.

Possible values:

* 0 — Desabilitado.
* 1 — Habilitado.
