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

# Memória, conexões e consultas lentas no banco de dados

> Corrija problemas de banco de dados na Square Cloud: RAM que não para de crescer, paradas por falta de memória, conexões demais, consultas lentas, disco cheio e início lento após uma parada forçada.

A maioria dos problemas de banco de dados aparece como memória que parece vazar, conexões que acabam ou consultas que ficam lentas. Comece pelo sintoma abaixo; os detalhes de cada engine estão nas páginas de [PostgreSQL](https://docs.squarecloud.app/pt-br/services/databases/postgresql.md), [MySQL](https://docs.squarecloud.app/pt-br/services/databases/mysql.md), [MongoDB](https://docs.squarecloud.app/pt-br/services/databases/mongodb.md) e [Redis](https://docs.squarecloud.app/pt-br/services/databases/redis.md).

## A RAM não para de crescer

**O que significa:** o gráfico de RAM do banco sobe depois que ele inicia e então fica alto, mesmo quando o tráfego cai.

**Por que acontece:** a RAM exibida no dashboard é a memória inteira da instância, incluindo o cache de arquivos do sistema operacional que o engine mantém aquecido. Cada engine também segura memória de propósito:

* **PostgreSQL:** o `shared_buffers` (25% da RAM) mais o cache de arquivos.
* **MongoDB:** o cache do WiredTiger, e um alocador que guarda a memória liberada para reutilizar.
* **MySQL:** o buffer pool do InnoDB (128 MB, a menos que você o tenha aumentado) mais o cache de arquivos.
* **Redis:** os próprios dados, até 90% da RAM.

Subir e depois estabilizar é normal, não é um vazamento.

**Quando é um problema:** se o banco ficar sem memória, ele é parado e continua parado até você iniciá-lo de novo (não há reinício automático depois de uma parada por falta de memória). Nesse caso:

1. Inicie-o pelo dashboard.
2. Descubra o que cresceu: uma query ou aggregation sobre dados demais, conexões demais (cada uma custa memória) ou, no Redis, chaves sem expiração.
3. Reduza isso, ou dê mais RAM ao banco.

## Conexões demais

**O que significa:** novas conexões são recusadas:

| Engine | Mensagem |
| :- | :- |
| PostgreSQL | `remaining connection slots are reserved for roles with the SUPERUSER attribute` / `sorry, too many clients already` |
| MySQL | `Too many connections` |
| MongoDB | a conexão fecha na hora |
| Redis | `max number of clients reached` |

**Por que acontece:** todo banco de dados aceita até 256 conexões simultâneas (253 para os seus clientes no PostgreSQL), seja qual for o tamanho. As causas mais comuns são um cliente ou uma conexão nova a cada requisição, um pool por módulo em vez de por processo, várias aplicações ou shards cada um com um pool grande ou, no MongoDB, muitas instâncias de `MongoClient` (cada uma soma 2 conexões de monitoramento ao seu pool).

**Como corrigir:**

1. Crie **um pool ou cliente por processo** na inicialização e reutilize-o em todo lugar (`pg.Pool`, `mysql2.createPool`, um `MongoClient`, um cliente Redis).
2. Dimensione os pools para que todos os processos juntos fiquem abaixo do limite, com folga: 4 processos com um pool de 20 usam 80.
3. Abra a aba **Insights** do banco para ver quais endereços de cliente estão com as conexões (a terceira parte de cada endereço IP fica mascarada).

## Consultas lentas

**O que significa:** as requisições à sua aplicação ficam lentas, e a CPU do banco continua alta.

**Como encontrá-las:** a aba **Insights** lista as consultas lentas, atualizada a cada 60 segundos:

* **PostgreSQL e MySQL:** instruções com o tempo médio, listadas assim que alguma execução levou 100 ms ou mais.
* **MongoDB:** operações individuais de 100 ms ou mais, do profiler.
* **Redis:** o `SLOWLOG`, comandos de 10 ms ou mais.

**Como corrigir:** rode o explain do engine na consulta lenta e adicione o índice de que ela precisa (`EXPLAIN ANALYZE` no PostgreSQL, `EXPLAIN` no MySQL, `explain("executionStats")` no MongoDB). No Redis, troque comandos que percorrem o keyspace inteiro ou uma chave gigante (`KEYS`, `HGETALL` em hashes enormes) por `SCAN`, `HSCAN` e `SSCAN`. Uma consulta que lê muitos dados também precisa de RAM: mais RAM mantém mais deles em cache.

## O banco de dados parou sozinho

| Causa | O que você vê | O que acontece depois |
| :- | :- | :- |
| Falta de memória | O banco está parado; o gráfico de RAM chegou ao limite. | Ele continua parado até você iniciá-lo. Veja [A RAM não para de crescer](#a-ram-não-para-de-crescer). |
| Queda com um erro | O banco parou de forma inesperada. | Ele reinicia automaticamente, no máximo uma vez por hora, e só se estava rodando havia pelo menos 60 segundos. |
| Armazenamento cheio (MongoDB) | O MongoDB parou de escrever e desligou. | Ele continua parado. Veja [O disco está cheio](#o-disco-está-cheio). |

## O disco está cheio

Cada banco de dados tem **10 GB de armazenamento**, fixos. Dados, índices e os arquivos do próprio engine dividem esse espaço: o write-ahead log do PostgreSQL (de 256 a 512 MB), os dados de diagnóstico do MongoDB (até 200 MB), a tabela `mysql.slow_log` do MySQL quando você ativa o slow log e, no Redis, o espaço de que um save precisa ao lado do arquivo de dados.

| Engine | O que acontece quando enche |
| :- | :- |
| PostgreSQL | As escritas falham (`could not extend file ... No space left on device`). |
| MySQL | As escritas falham (`The table '...' is full`). |
| MongoDB | O servidor para e não volta sozinho. |
| Redis | Os saves falham, e as escritas respondem `MISCONF` até um save dar certo. |

**Como corrigir:**

1. Apague ou arquive os dados de que você não precisa, e remova os índices sem uso. Arquivos como imagens e uploads ficam no [Blob Storage](https://docs.squarecloud.app/pt-br/services/blob.md), não no banco de dados.
2. Recupere o espaço: no PostgreSQL, um `VACUUM` simples deixa o espaço reutilizável dentro da tabela, enquanto o `VACUUM FULL` o devolve ao disco, mas precisa de espaço livre do tamanho da tabela enquanto roda. No MySQL, o `OPTIMIZE TABLE` reconstrói a tabela. No MongoDB, o `compact` na coleção.
3. No MongoDB, inicie o banco pelo dashboard primeiro e libere espaço logo em seguida.

> [!WARNING]
>
> Um banco perto dos 10 GB também pode não conseguir fazer snapshot: uma exportação é limitada a cerca de 10 GB, e as exportações de PostgreSQL e MySQL são texto SQL sem compressão. Mantenha uma folga.

## Demora para iniciar depois de uma parada

**O que significa:** logo depois de iniciar, o PostgreSQL responde `the database system is not yet accepting connections`, ou o MySQL demora muito para aceitar conexões.

**Por que acontece:** parar um banco dá a ele 5 segundos para desligar de forma limpa; um banco ocupado pode precisar de mais tempo e então é parado à força. No próximo início, ele roda a recuperação de falhas (o PostgreSQL reaplica o write-ahead log, o InnoDB do MySQL recupera as tabelas), o que demora mais em bancos grandes.

**Como corrigir:** aguarde a recuperação terminar; nada se perde com a espera. Pare o banco quando a carga de escrita estiver baixa.

## Guias relacionados

* [Visão geral de Bancos de dados](https://docs.squarecloud.app/pt-br/services/databases.md): limites, snapshots, Insights e o que todo banco de dados inclui.
* [Erros de conexão com banco de dados](https://docs.squarecloud.app/pt-br/platform/troubleshooting/database-connection-errors.md): erros de SSL/TLS, autenticação e rede.

## Contate-nos

Se você continuar enfrentando **dificuldades técnicas**, nossa **equipe de suporte especializada** está disponível para auxiliá-lo. [**Entre em contato conosco**](https://squarecloud.app/pt-br/support) e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com [**4,9/5 em 402 avaliações**](https://www.trustpilot.com/review/squarecloud.app) no Google e Trustpilot.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.