O AOF (append-only file) é o modo de persistência do Redis que registra as operações de escrita recebidas pelo servidor. Cada comando que altera uma chave entra no arquivo. Na partida, o Redis lê o log e repete as operações para reconstruir o estado que existia antes do reinício.
A diferença para o RDB está no que cada modo grava: o RDB tira uma fotografia periódica do conjunto de chaves, e o AOF registra a sequência de mudanças. Uma fila com tarefas pendentes precisa do segundo, porque a fotografia pode ser antiga e perder o que chegou depois dela.
Como ligar e conferir
O AOF vem desligado no arquivo de configuração padrão. Para ativá-lo, a diretiva é:
appendonly yesCom a persistência ligada, os arquivos ficam na pasta de trabalho do Redis. Desde a versão 7.0, o AOF é dividido em uma base, um arquivo incremental e um manifesto dentro de appendonlydir. Na imagem oficial do Docker, a pasta de trabalho é o volume /data. Sem um volume nomeado ou uma pasta da VPS montada nesse caminho, um container novo começa vazio.
A conferência combina o estado do servidor com os arquivos. O comando INFO persistence mostra se o AOF está ativo e se há reescrita em andamento. A presença do arquivo no volume confirma que a gravação está chegando ao disco usado pelo container.
As três políticas de fsync
A diretiva appendfsync define a frequência com que o Redis solicita ao sistema operacional a descarga do log no disco:
| Valor | Quando grava | O que se perde numa queda |
|---|---|---|
always |
A cada lote, antes de responder ao cliente | Quase nada, com custo alto de desempenho |
everysec |
Uma vez por segundo, numa thread separada | Até cerca de um segundo de escrita |
no |
Quando o sistema operacional descarregar o buffer | As escritas desde a última descarga |
O padrão é everysec, que equilibra desempenho e perda máxima de um segundo. Para uma fila de e-mails, esse segundo pode significar uma tarefa perdida. Para um cache, o mesmo segundo raramente importa, porque a chave pode ser consultada de novo na origem.
A reescrita reduz o arquivo
Um contador incrementado cem vezes deixa cem comandos no AOF, mesmo que o valor final caiba numa linha. Para conter o crescimento, o Redis reescreve o arquivo em segundo plano. Ele monta uma base nova com o mínimo de comandos necessários para chegar ao estado atual e troca o manifesto quando a base fica pronta.
A reescrita pode ser disparada pelo comando BGREWRITEAOF ou pelas opções de crescimento automático. Durante o processo, o Redis continua aceitando escritas e grava as novas operações no arquivo incremental. O manifesto indica qual conjunto de arquivos forma o AOF atual.
O que o AOF não protege
O log registra comandos, inclusive os destrutivos. Um FLUSHALL enviado por um cliente indevido entra no AOF e se repete na partida. A persistência recupera o estado, mas não desfaz o comando. Por isso a configuração de ACL e a restrição de rede continuam fazendo parte da proteção do Redis.
Um backup também não se resume a copiar um arquivo. A pasta appendonlydir precisa ser copiada inteira, com a base, o incremental e o manifesto. Copiar só um dos arquivos produz um conjunto que o Redis não consegue carregar. O guia de persistência do portal mostra essa estrutura em detalhe.
Dúvidas frequentes
Perguntas frequentes sobre AOF
- O AOF substitui o backup?
- Não. O AOF reconstrói o estado depois de um reinício, mas um comando errado também entra no log e se repete na partida. Uma cópia externa continua necessária para recuperar o estado anterior a esse comando.
- Qual é a diferença entre AOF e RDB?
- O RDB grava uma fotografia periódica do conjunto de chaves. O AOF registra as operações de escrita. O RDB produz um arquivo menor e uma partida mais rápida; o AOF reduz a janela de perda, ao custo de mais escrita em disco.
- O AOF pode ficar maior que o conjunto de chaves?
- Sim. Cada operação acrescenta uma entrada, mesmo quando o valor final é pequeno. O Redis reescreve o arquivo em segundo plano para reduzir o tamanho e troca os arquivos quando a nova base fica pronta.
Para continuar
Recursos relacionados
Documentação
Redis: persistência
Compara RDB e AOF, explica as políticas de fsync, a reescrita do arquivo e a combinação dos dois modos.
Abrir recursoRepositório
Redis: arquivo de configuração
Mostra as diretivas appendonly, appendfsync e appenddirname com os valores padrão da versão.
Abrir recursoSite de referência
Promovaweb: persistência no Redis
Detalha a pasta appendonlydir, o manifesto e o efeito de cada política de fsync numa fila de aplicação.
Abrir recursoAplicação na formação
Formação DevOps
Ao subir o Redis de uma fila na VPS, você escolhe o modo de persistência e confere o volume que guarda o AOF antes de reiniciar o container.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.