Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
O log binário do MySQL registra cada mudança feita no banco de dados — inserções, atualizações, exclusões, mudanças de esquema. Ele é a base da replicação e da recuperação pontual. A maioria dos servidores MySQL de produção roda com o log binário habilitado.

Habilitando o Log Binário

O log binário é habilitado por padrão no MySQL 8.0. Para verificar:
Configure-o em my.cnf / my.ini:
Depois que log_bin é definido, o MySQL nomeia os arquivos de binlog como mysql-bin.000001, mysql-bin.000002 etc., com um arquivo de índice (mysql-bin.index) que lista todos eles.

Formatos do Log Binário

O MySQL suporta três formatos de binlog: O formato ROW é o padrão recomendado. Ele replica corretamente mesmo quando funções não determinísticas como RAND() ou UUID() estão envolvidas. A desvantagem são arquivos de log maiores — um único UPDATE que toca milhões de linhas produz uma instrução no formato STATEMENT, mas um evento de linha por linha afetada no formato ROW.

Quando habilitar o log binário e qual formato escolher

O log binário é habilitado por padrão no MySQL 8.0+. A questão costuma ser qual formato usar e se deve deixá-lo ligado. Verifique e altere o formato:

Listando e Visualizando Logs Binários

Liste todos os arquivos de log binário:
Verifique o arquivo e a posição atuais do binlog:
Visualize os eventos de um binlog a partir do SQL:

mysqlbinlog

A ferramenta mysqlbinlog decodifica os arquivos de log binário em SQL legível por humanos. Ela é usada para recuperação pontual e auditoria:

Recuperação Pontual

Combinar um backup completo com os logs binários permite restaurar para qualquer ponto no tempo depois que o backup foi tirado. Fluxo de trabalho típico:
  1. Tire um backup completo com mysqldump --single-transaction --source-data:
--source-data=2 grava o nome do arquivo e a posição do binlog como um comentário no dump. Esse é o seu ponto de partida para a recuperação.
  1. Restaure o backup completo:
  1. Encontre o arquivo e a posição do binlog no dump:
  1. Reproduza os binlogs a partir dessa posição até imediatamente antes do evento que você quer desfazer:

Gerenciando Logs Binários

Limpe manualmente os logs binários antigos:
Limpeza automática com binlog_expire_logs_seconds (MySQL 8.0+; expire_logs_days foi removido):
Nunca exclua arquivos de binlog diretamente com rm — use PURGE BINARY LOGS para que o arquivo de índice continue consistente.

Perguntas Frequentes

O log binário afeta o desempenho de escrita?

Sim, moderadamente. O log no formato ROW adiciona uma sobrecarga proporcional à quantidade de dados alterados. Para cargas de trabalho com muitas escritas, a sobrecarga normalmente fica entre 5 e 15%. Quase sempre vale a pena pelas capacidades de recuperação e replicação que ele habilita.

Posso pular o log binário em uma sessão específica?

Isso é útil para carregar dados em uma réplica que não precisa propagá-los adiante, ou para operações em massa que você quer excluir do escopo da recuperação pontual. Requer SUPER, SYSTEM_VARIABLES_ADMIN ou SESSION_VARIABLES_ADMIN — BINLOG_ADMIN sozinho não basta, e a tentativa falha com ERROR 1227.

Como sei quanto espaço em disco meus logs binários estão usando?

Ou no disco: du -sh /var/log/mysql/mysql-bin.*

Solução de Problemas

Veja também