Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Use the WAL log management feature

Última atualização: Jun 26, 2026

Slots de replicação inativos provocam o acúmulo contínuo de logs WAL (write-ahead logging). Se não forem tratados, esses logs acumulados esgotam o espaço em disco, bloqueiam a instância e impedem todas as requisições de escrita. Utilize o recurso de gerenciamento de logs WAL para identificar e excluir slots de replicação inativos antes que eles afetem sua carga de trabalho.

Aviso

Exclua os slots de replicação inativos prontamente. O acúmulo de logs WAL pode causar a seguinte falha crítica:

  • Bloqueio da instância: quando o espaço em disco se esgota, a instância muda para o modo somente leitura e rejeita todas as requisições de escrita.

Não é possível reutilizar slots de replicação excluídos.

Contexto

Um slot de replicação rastreia o progresso da replicação e garante a retenção dos logs WAL até que todos os assinantes os consumam. Isso evita perda de dados na replicação em streaming.

Um slot torna-se inativo quando seu assinante se desconecta, apresenta configuração incorreta ou tem um longo atraso de replicação. Enquanto permanece inativo, o slot retém logs WAL indefinidamente — o checkpointer não consegue excluí-los até que o slot seja removido ou reativado.

Pré-requisitos

Antes de começar, verifique se você possui:

Gerencie slots de replicação

Visualize slots de replicação

No console:

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde sua instância está localizada. Clique em ID da instância.

  2. No painel de navegação à esquerda, escolha Logs > WAL Logs.

  3. Na aba WAL File Management, revise a lista de slots de replicação.

A coluna Whether Active (mapeada para o campo active) exibe o status de cada slot. Slots com status INACTIVE estão acumulando logs WAL.

A tabela a seguir descreve todos os campos da aba WAL File Management.

Coluna

**Campo em pg_replication_slots**

Descrição

Slot name

slot_name

Nome do slot de replicação.

Slot type

slot_type

Tipo do slot de replicação: physical ou logical.

Plugin

plugin

Plugin de saída utilizado pelo slot. O ApsaraDB RDS for PostgreSQL suporta test_decoding, pgoutput e wal2json por padrão.

Temporary slot

temporary

Indica se o slot é temporário. Um slot temporário existe apenas durante a sessão atual e é excluído automaticamente ao final da sessão. Valores: true (temporário), false (permanente).

Database name

database

Banco de dados onde o slot de replicação reside.

Accumulated WAL files

Calculado pelo AliPG

Volume de logs WAL acumulados para o slot, em MB. Calculado usando pg_wal_lsn_diff(pg_current_wal_insert_lsn(), restart_lsn).

Logical subscription latency

Calculado pelo AliPG

Atraso de replicação no nó assinante correspondente a este slot, em segundos. Calculado a partir de pg_stat_replication.

Whether active

active

Indica se o slot está em uso. Valores: ACTIVE, INACTIVE.

Exclua um slot de replicação inativo

No console:

  1. Na aba WAL File Management, localize um slot com INACTIVE na coluna Whether Active.

  2. Caso o slot de replicação ainda esteja em uso, altere o estado para ACTIVE.

  3. Se o slot não for mais necessário, clique em Delete na coluna Actions.

Nota

Não é possível excluir slots de replicação ativos.

Após a exclusão, os logs WAL retidos pelo slot são liberados automaticamente e limpos pelo checkpointer.

Observações de uso

  • Slots de replicação ativos não podem ser excluídos.

  • Um slot de replicação excluído não pode ser reutilizado. Se a replicação ainda for necessária, crie um novo slot.

Parâmetros relacionados

Os seguintes parâmetros do PostgreSQL controlam a retenção de logs WAL e o comportamento de checkpoint. Configure-os nos parâmetros da instância.

Parâmetro

Descrição

max_wal_size

Tamanho do log WAL que aciona um checkpoint.

min_wal_size

Tamanho mínimo de log WAL retido em disco para reutilização em um checkpoint futuro. Logs WAL abaixo desse limiar são reciclados em vez de excluídos.

wal_buffers

Quantidade de memória compartilhada usada para dados WAL ainda não gravados em disco.

Próximos passos

Referência de API

  • DescribeSlots: consulta todos os slots de replicação de uma instância.

  • DeleteSlot: exclui um slot de replicação de uma instância.