> ## 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 max_memory_usage_*

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

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](/docs/pt-BR/reference/system-tables/settings) e são autogeradas a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="max_memory_usage">
  ## max\_memory\_usage
</div>

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

Valor padrão no Cloud: depende da quantidade de RAM na réplica.

A quantidade máxima de RAM a ser usada para executar uma consulta em um único servidor.
Um valor de `0` significa ilimitado.

Essa configuração não considera a quantidade de memória disponível nem a quantidade total
de memória na máquina. A restrição se aplica a uma única consulta em um
único servidor.

Você pode usar `SHOW PROCESSLIST` para ver o consumo de memória atual de cada consulta.
O pico de consumo de memória é rastreado para cada consulta e registrado no log.

O uso de memória não é totalmente rastreado para os estados das seguintes funções de agregação
com argumentos `String` e `Array`:

* `min`
* `max`
* `any`
* `anyLast`
* `argMin`
* `argMax`

O consumo de memória também é restringido pelos parâmetros [`max_memory_usage_for_user`](/docs/pt-BR/reference/settings/session-settings/max-memory-usage#max_memory_usage_for_user)
e [`max_server_memory_usage`](/docs/pt-BR/reference/settings/server-settings/settings#max_server_memory_usage).

<div id="max_memory_usage_for_user">
  ## max\_memory\_usage\_for\_user
</div>

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

A quantidade máxima de RAM usada para executar as consultas de um usuário em um único servidor. Zero significa ilimitado.

Por padrão, essa quantidade não é restrita (`max_memory_usage_for_user = 0`).

Veja também a descrição de [`max_memory_usage`](/docs/pt-BR/reference/settings/session-settings/max-memory-usage#max_memory_usage).

Por exemplo, se você quiser definir `max_memory_usage_for_user` como 1000 bytes para um usuário chamado `clickhouse_read`, poderá usar a instrução

```sql theme={null}
ALTER USER clickhouse_read SETTINGS max_memory_usage_for_user = 1000;
```

Você pode verificar se funcionou encerrando a sessão no cliente, entrando novamente e, em seguida, usando a função `getSetting`:

```sql theme={null}
SELECT getSetting('max_memory_usage_for_user');
```