Curso de MariaDB / Entender replicação, atraso, erros e troca de servidor
A replicação assíncrona padrão do MariaDB transmite as alterações de um servidor principal a uma réplica, que as aplica aos seus dados. Ter uma réplica não garante que ela esteja atualizada ou que a troca em caso de falha seja automática: gerencie em conjunto atraso, erros, possível perda de dados e caminho de gravação da aplicação.
Acompanhar uma alteração do principal à réplica
O principal grava as alterações em seu log binário. A thread receptora da réplica coleta esses registros em um log de retransmissão, ou relay log; o mecanismo de aplicação os processa depois nos dados da réplica. A replicação paralela pode usar vários trabalhadores, mas receber e aplicar continuam sendo etapas distintas.
Um COMMIT bem-sucedido no principal não significa que uma réplica assíncrona terminou de aplicar a transação. Ler a réplica logo após uma gravação pode retornar um valor anterior. Requisições que precisam ler o que acabou de ser gravado exigem uma política explícita de roteamento. As referências de configuração da replicação e GTID do MariaDB explicam os logs e as posições.
GTID significa Global Transaction ID, identificador global de transação, e permite acompanhar posições de replicação. Sua presença não valida automaticamente os dados nem torna toda réplica pronta para ser principal. MariaDB e MySQL têm implementações GTID diferentes; compartilhar o nome não implica compatibilidade de sintaxe ou comportamento.
Preparar dois servidores novos para a primeira prática
Pule esta preparação se já tiver uma réplica de estudos corretamente configurada. Para a primeira prática, use um projeto novo com volumes vazios, nunca servidores de produção ou uma réplica preexistente. O exemplo usa a abordagem de arquivos de senhas do ambiente MariaDB com Docker Compose.
Em uma pasta nova, crie secrets/primary-root.txt e secrets/replica-root.txt, cada um com uma senha root diferente em uma única linha. Exclua secrets/ do controle de versão e proteja os arquivos locais. Salve o seguinte como compose.yaml. Não são publicadas portas do computador: os servidores se comunicam em uma rede interna do Compose. A tag mariadb:11.8 acompanha uma família de revisões de manutenção; registre um digest aprovado se precisar reproduzir uma imagem exata.
name: mariadb-replication-lab
services:
primary:
image: mariadb:11.8
environment:
MARIADB_ROOT_PASSWORD_FILE: /run/secrets/primary_root
secrets: [primary_root]
command: ["--server-id=11", "--log-bin=primary-bin", "--binlog-format=ROW", "--gtid-strict-mode=ON"]
volumes: [primary_data:/var/lib/mysql]
networks: [replication]
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
retries: 10
start_period: 30s
replica:
image: mariadb:11.8
environment:
MARIADB_ROOT_PASSWORD_FILE: /run/secrets/replica_root
secrets: [replica_root]
command: ["--server-id=12", "--log-bin=replica-bin", "--binlog-format=ROW", "--gtid-strict-mode=ON", "--read-only=ON"]
volumes: [replica_data:/var/lib/mysql]
networks: [replication]
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
retries: 10
start_period: 30s
secrets:
primary_root:
file: ./secrets/primary-root.txt
replica_root:
file: ./secrets/replica-root.txt
volumes:
primary_data:
replica_data:
networks:
replication:
internal: true
Confira se Docker e Compose estão disponíveis e execute nesta pasta. Se o nome do projeto já estiver em uso, escolha outro antes de iniciar para evitar reutilizar seus volumes.
docker compose config --quiet
docker compose up -d
docker compose ps
Espere os dois serviços ficarem healthy, ou seja, passarem pela verificação de estado. Configure a replicação antes de inserir dados da aplicação. Abra primeiro o cliente administrativo local do principal:
docker compose exec primary mariadb -u root -p
Informe a senha de primary-root.txt e substitua a senha pública de demonstração por uma própria antes de executar:
CREATE USER 'repl_lab'@'%' IDENTIFIED BY 'Replace_With_A_Unique_Replication_Password';
GRANT REPLICATION SLAVE ON *.* TO 'repl_lab'@'%';
SHOW GRANTS FOR 'repl_lab'@'%';
\q
A última linha \q sai do cliente; é uma ordem do cliente, não SQL do servidor. O padrão de Host % não concede por si só direitos administrativos: aqui é concedida somente replicação em uma rede de estudos sem portas publicadas. Uma implantação remota exige restringir a origem e configurar TLS, protocolo de proteção dos dados em trânsito. Não transfira diretamente esse escopo de laboratório para uma rede compartilhada.
Abra depois o cliente administrativo da réplica e informe a senha de replica-root.txt:
docker compose exec replica mariadb -u root -p
Nessa conexão, forneça a mesma senha nova de replicação usada no principal. Não publique comandos ou saídas com segredos reais.
CHANGE MASTER TO
MASTER_HOST='primary', MASTER_PORT=3306,
MASTER_USER='repl_lab',
MASTER_PASSWORD='Replace_With_A_Unique_Replication_Password',
MASTER_USE_GTID=slave_pos;
START REPLICA;
SHOW REPLICA STATUS\G
A inicialização pressupõe dois servidores novos e vazios e os logs necessários ainda disponíveis no principal. Se já houver dados ou faltarem logs, prepare primeiro uma cópia inicial consistente e sua posição correspondente. As coordenadas de conexão não conciliam dados divergentes. Confira se as duas threads indicam Yes antes de continuar.
A configuração Docker precisa ser verificada no seu ambiente pelos estados e logs dos contêineres. Os exercícios de transferência e pausa abaixo foram verificados com dois servidores nativos temporários MariaDB 12.3.3, com identificadores distintos, log binário ROW e GTID. Isso não constitui um teste de inicialização da imagem Docker ou de TLS remoto.
Confirmar a topologia e as permissões de diagnóstico
As consultas seguintes examinam uma topologia já configurada. Ela exige server_id diferentes, log binário do principal, conta de replicação, caminho de rede e dados inicialmente consistentes. Examinar o estado exige permissões adequadas à versão, como REPLICA MONITOR, diferentes das permissões para interromper threads. Uma aplicação não precisa de acesso administrativo completo para permitir monitoramento operacional.
No principal, confirme a identidade e o log binário e anote a posição:
SELECT @@server_id AS server_id, @@log_bin AS binary_logging,
@@GLOBAL.gtid_binlog_pos AS logged_gtid;
SHOW MASTER STATUS;
Na réplica, execute:
SELECT @@server_id AS server_id, @@GLOBAL.read_only AS read_only,
@@GLOBAL.gtid_slave_pos AS applied_gtid;
SHOW REPLICA STATUS\G
Desde o MariaDB 12.0, read_only é uma enumeração que também oferece NO_LOCK e NO_LOCK_NO_ADMIN. Interprete o resultado conforme a versão em vez de exigir sempre 0 ou 1 numérico. A referência de read_only descreve os modos.
\G é um terminador de saída vertical do cliente de linha de comando mariadb. Ele não é enviado literalmente por uma API SQL: um driver transmite a instrução SQL e lê suas colunas de resultado.
Interpretar os campos de estado em conjunto
| Campo | Interpretação |
|---|---|
| Slave_IO_Running | Estado de recepção; Yes sozinho não demonstra que os dados foram aplicados |
| Slave_SQL_Running | Estado de aplicação; diferencie uma pausa voluntária de um erro |
| Last_IO_Error e Last_SQL_Error | Indícios para separar falhas de transporte ou autenticação de falhas ao aplicar |
| Seconds_Behind_Master | Indicador dependente do estado e do momento; nem 0 nem NULL demonstram sozinhos um estado correto |
| Gtid_IO_Pos e @@GLOBAL.gtid_slave_pos | Posições recebida e aplicada, interpretadas conforme os domínios e a topologia |
Mesmo que o comando seja SHOW REPLICA STATUS, as colunas podem manter os nomes históricos Slave e Master. A ordem também pode variar entre versões: um programa de monitoramento deve ler os campos por nome, em vez de posições numéricas fixas. A referência SHOW REPLICA STATUS descreve os campos.
As duas threads estarem ativas, uma gravação específica chegar e a perda potencial diante de uma falha ser aceitável são verificações diferentes. Anote estados e posições e confira os dados ou marcadores de negócio necessários. Um atraso pequeno não descarta divergências causadas por filtros ou gravações involuntárias na réplica.
Observar uma pausa de aplicação no laboratório
Faça isso somente em uma topologia separada e descartável, com permissões de controle de threads. Não é um procedimento para parar uma réplica de produção durante um diagnóstico. No principal, crie a tabela de teste; se o nome já existir, examine-a antes de repetir CREATE:
CREATE DATABASE IF NOT EXISTS replication_lab;
CREATE TABLE replication_lab.probe (
probe_id INT PRIMARY KEY,
marker VARCHAR(40) NOT NULL
) ENGINE=InnoDB;
INSERT INTO replication_lab.probe VALUES (1, 'before-pause');
Na réplica, repita esta leitura até observar a primeira linha ou examine o estado e os erros se ela não chegar:
SELECT probe_id, marker FROM replication_lab.probe ORDER BY probe_id;
O marcador before-pause significa antes da pausa. Na réplica, pare somente a thread de aplicação. A receptora pode continuar coletando logs, permitindo diferenciar registros recebidos de dados visíveis.
STOP REPLICA SQL_THREAD;
No principal, acrescente a segunda linha, cujo marcador during-pause significa durante a pausa:
INSERT INTO replication_lab.probe VALUES (2, 'during-pause');
A consulta na réplica ainda deve mostrar somente a primeira linha. Confira também SHOW REPLICA STATUS para observar recepção ativa e aplicação parada. Depois de verificar a diferença, retome a aplicação na réplica:
START REPLICA SQL_THREAD;
SELECT probe_id, marker FROM replication_lab.probe ORDER BY probe_id;
Sem filtros ou erros que impeçam a aplicação, a segunda linha deve chegar. Aplicar leva tempo: uma única leitura imediata sem a linha não demonstra falha definitiva. Também não espere indefinidamente sem conferir o estado e o último erro. Não copie uma ordem de retomada para um ambiente cuja replicação esteja parada por outra operação.
Confirme o retorno ao estado ativo inicial. Quando não precisar mais do teste, remova a tabela no principal com DROP TABLE replication_lab.probe; e confirme seu desaparecimento na réplica. Não remova objetos de negócio nem reinicialize a configuração de replicação para retirar essa tabela.
Preservar evidências antes de pular ou reinicializar eventos
| Problema | O que investigar primeiro | Resposta prematura a evitar |
|---|---|---|
| A receptora não conecta | Endereço, porta, DNS, firewall, TLS, conta e último erro de IO | Desativar autenticação ou criptografia |
| A aplicação dos registros para | Chaves duplicadas, linhas ausentes, diferenças de estrutura, filtros e último erro SQL | Pular um evento sem entender seu efeito nos dados |
| O log necessário está ausente | Retenção do principal, posição da réplica e consistência da cópia inicial | Forçar uma posição sem os dados consistentes correspondentes |
| O atraso aumenta | Gravações, entrada e saída e CPU da réplica, transações grandes e bloqueios | Promover um servidor com base em um único indicador |
Preserve primeiro estados e erros com data e hora. Diante de divergências, considere reconstruir a réplica a partir de uma cópia consistente. Pular um evento pode reativar as threads deixando dados ausentes ou inconsistentes. A replicação também pode propagar um DELETE errado; não substitui backups independentes nem a verificação de restauração.
Tratar a troca de servidor como controle do caminho de gravação
- Determine a falha e isole o principal anterior de novas gravações. Uma partição de rede não demonstra sozinha que ele deixou de aceitá-las.
- Examine as posições recebidas e aplicadas das réplicas candidatas, o trabalho pendente, os erros e a perda potencial.
- Avalie o RPO, Recovery Point Objective ou objetivo de ponto de recuperação, que expressa a perda aceitável, e o RTO, Recovery Time Objective ou objetivo de tempo de recuperação, que expressa o prazo aceitável para restabelecer o serviço.
- Siga o procedimento aprovado de promoção e roteamento para estabelecer um único destino de gravação e confira as leituras e gravações da aplicação.
- Antes de reintegrar o antigo principal recuperado, confira a consistência e reconstrua esse servidor como réplica se necessário.
No modo ON do exemplo, read_only limita gravações de usuários comuns; não bloqueia absolutamente toda gravação privilegiada. Consulte as exceções de permissões das réplicas somente leitura. Desativar read_only não constitui um procedimento completo de promoção. Evitar split brain, situação em que dois servidores aceitam gravações simultaneamente, exige isolar o principal anterior e controlar em conjunto roteamento e conexões.





