Separação leitura/escrita e health checks de réplicas com ProxySQL

Comando

-- On MySQL (source): monitor user
CREATE USER 'proxysql_mon'@'%' IDENTIFIED BY 'M0n#itor2024';
GRANT USAGE, REPLICATION CLIENT ON *.* TO 'proxysql_mon'@'%';

-- ProxySQL admin: mysql -u admin -p -h 127.0.0.1 -P 6032
UPDATE global_variables SET variable_value = 'proxysql_mon' WHERE variable_name = 'mysql-monitor_username';
UPDATE global_variables SET variable_value = 'M0n#itor2024' WHERE variable_name = 'mysql-monitor_password';
LOAD MYSQL VARIABLES TO RUNTIME; SAVE MYSQL VARIABLES TO DISK;
INSERT INTO mysql_replication_hostgroups (writer_hostgroup, reader_hostgroup, check_type, comment) VALUES (10, 20, 'read_only', 'shop');
INSERT INTO mysql_servers (hostgroup_id, hostname, port, max_replication_lag) VALUES (10, 'db1', 3306, 0), (20, 'db2', 3306, 30), (20, 'db3', 3306, 30);
LOAD MYSQL SERVERS TO RUNTIME; SAVE MYSQL SERVERS TO DISK;
INSERT INTO mysql_users (username, password, default_hostgroup, transaction_persistent) VALUES ('app', 'App#Pass2024', 10, 1);
LOAD MYSQL USERS TO RUNTIME; SAVE MYSQL USERS TO DISK;
INSERT INTO mysql_query_rules (rule_id, active, match_digest, destination_hostgroup, apply) VALUES (100, 1, '^SELECT .* FOR (UPDATE|SHARE)', 10, 1), (200, 1, '^SELECT ', 20, 1);
LOAD MYSQL QUERY RULES TO RUNTIME; SAVE MYSQL QUERY RULES TO DISK;

-- Verify
SELECT hostgroup_id, hostname, status FROM runtime_mysql_servers;
SELECT hostgroup, srv_host, status, ConnUsed, Queries, Latency_us FROM stats_mysql_connection_pool;
SELECT hostgroup, substr(digest_text, 1, 60) AS digest, count_star, sum_time / 1000 AS sum_ms FROM stats_mysql_query_digest ORDER BY sum_time DESC LIMIT 10;

O que faz

Gerencia automaticamente os hostgroups writer (10) e reader (20) com base na flag read_only; encaminha SELECTs às réplicas e leituras com lock e gravações à source; remove temporariamente uma réplica que excede max_replication_lag (SHUNNED).

Quando usar

Para distribuir a carga de leitura em uma topologia de replicação assíncrona sem mexer na aplicação; para pooling de conexões e roteamento / cache / firewall por consulta.

Atenção

A configuração tem 3 camadas (MEMORY → RUNTIME → DISK): sem LOAD ... TO RUNTIME nada muda, sem SAVE ... TO DISK tudo se perde no restart. A verificação de read_only exige super_read_only=ON nas réplicas; caso contrário as réplicas são movidas para o hostgroup writer. Enviar todo SELECT às réplicas causa erros de read-after-write por causa do lag; escrever regras apenas para consultas pesadas / de relatório com base em stats_mysql_query_digest é mais seguro. A interface de administração é SQLite: funções do MySQL como LEFT() não existem, use substr(). Altere a conta padrão admin:admin (admin-admin_credentials).