> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# configurações de sessão prefer_*

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

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>;
};

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'Somente no ClickHouse Cloud'}
        </div>;
};

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

<div id="prefer_column_name_to_alias">
  ## prefer\_column\_name\_to\_alias
</div>

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

Habilita ou desabilita o uso dos nomes originais das colunas em vez de aliases em expressões e cláusulas de consulta. Isso é especialmente relevante quando o alias é igual ao nome da coluna; veja [Expression Aliases](/docs/pt-BR/reference/syntax#notes-on-usage). Habilite essa configuração para tornar as regras de sintaxe de aliases no ClickHouse mais compatíveis com a maioria dos outros motores de banco de dados.

Possíveis valores:

* 0 — O nome da coluna é substituído pelo alias.
* 1 — O nome da coluna não é substituído pelo alias.

**Exemplo**

A diferença entre habilitado e desabilitado:

Consulta:

```sql theme={null}
SET prefer_column_name_to_alias = 0;
SELECT avg(number) AS number, max(number) FROM numbers(10);
```

Resultado:

```text theme={null}
Received exception from server (version 21.5.1):
Code: 184. DB::Exception: Received from localhost:9000. DB::Exception: Aggregate function avg(number) is found inside another aggregate function in query: While processing avg(number) AS number.
```

Consulta:

```sql theme={null}
SET prefer_column_name_to_alias = 1;
SELECT avg(number) AS number, max(number) FROM numbers(10);
```

Resultado:

```text theme={null}
┌─number─┬─max(number)─┐
│    4.5 │           9 │
└────────┴─────────────┘
```

<div id="prefer_external_sort_block_bytes">
  ## prefer\_external\_sort\_block\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="16744704" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.5"},{"label": "16744704"},{"label": "Prioriza o número máximo de bytes por bloco na ordenação externa, reduzindo o uso de memória durante a mesclagem."}]}]} />

Prioriza o número máximo de bytes por bloco na ordenação externa, reduzindo o uso de memória durante a mesclagem.

<div id="prefer_global_in_and_join">
  ## prefer\_global\_in\_and\_join
</div>

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

Habilita a substituição dos operadores `IN`/`JOIN` por `GLOBAL IN`/`GLOBAL JOIN`.

Valores possíveis:

* 0 — Desabilitado. Os operadores `IN`/`JOIN` não são substituídos por `GLOBAL IN`/`GLOBAL JOIN`.
* 1 — Habilitado. Os operadores `IN`/`JOIN` são substituídos por `GLOBAL IN`/`GLOBAL JOIN`.

**Uso**

Embora `SET distributed_product_mode=global` possa alterar o comportamento das consultas para as tabelas distribuídas, ele não é adequado para tabelas locais nem para tabelas de fontes externas. É nesse ponto que a configuração `prefer_global_in_and_join` entra em ação.

Por exemplo, temos nós que processam consultas e contêm tabelas locais, que não são adequadas para distribuição. Precisamos distribuir seus dados dinamicamente durante o processamento distribuído com a palavra-chave `GLOBAL` — `GLOBAL IN`/`GLOBAL JOIN`.

Outro caso de uso de `prefer_global_in_and_join` é acessar tabelas criadas por motores externos. Essa configuração ajuda a reduzir o número de chamadas a fontes externas ao fazer JOIN dessas tabelas: apenas uma chamada por consulta.

**Veja também:**

* [Subconsultas distribuídas](/docs/pt-BR/reference/statements/in#distributed-subqueries) para mais informações sobre como usar `GLOBAL IN`/`GLOBAL JOIN`

<div id="prefer_localhost_replica">
  ## prefer\_localhost\_replica
</div>

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

Ativa/desativa o uso preferencial da réplica localhost ao processar consultas distribuídas.

Valores possíveis:

* 1 — o ClickHouse sempre envia uma consulta para a réplica localhost, se ela existir.
* 0 — o ClickHouse usa a estratégia de balanceamento especificada na configuração [load\_balancing](/docs/pt-BR/reference/settings/session-settings/load-balancing#load_balancing).

<Note>
  Desative esta configuração se usar [max\_parallel\_replicas](/docs/pt-BR/reference/settings/session-settings/max#max_parallel_replicas) sem [parallel\_replicas\_custom\_key](/docs/pt-BR/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key).
  Se [parallel\_replicas\_custom\_key](/docs/pt-BR/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key) estiver definida, desative esta configuração somente se ela for usada em um cluster com vários shards contendo várias réplicas.
  Se ela for usada em um cluster com um único shard e várias réplicas, desativar esta configuração terá efeitos negativos.
</Note>

<div id="prefer_warmed_unmerged_parts_seconds">
  ## prefer\_warmed\_unmerged\_parts\_seconds
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="Int64" default_value="0" />

Só tem efeito no ClickHouse Cloud. Se uma parte mesclada tiver menos do que essa quantidade de segundos e não estiver pré-aquecida (consulte [cache\_populated\_by\_fetch](/docs/pt-BR/reference/settings/merge-tree-settings#cache_populated_by_fetch)), mas todas as suas partes de origem estiverem disponíveis e pré-aquecidas, as consultas SELECT serão lidas dessas partes. Apenas para Replicated-/SharedMergeTree. Observe que isso verifica apenas se o CacheWarmer processou a parte; se a parte tiver sido carregada no cache por outro mecanismo, ela ainda será considerada fria até que o CacheWarmer a processe; se tiver sido aquecida e depois removida do cache, ainda será considerada aquecida.
