División de lectura/escritura y comprobaciones de salud de réplicas con 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;

Qué hace

Gestiona automáticamente los hostgroups de escritura (10) y lectura (20) según el indicador read_only; enruta los SELECT a las réplicas y las lecturas con bloqueo y las escrituras al origen; retira temporalmente una réplica que supera max_replication_lag (SHUNNED).

Cuándo usarlo

Para repartir la carga de lectura en una topología de replicación asíncrona sin tocar la aplicación; para connection pooling y enrutamiento / cache / firewall por consulta.

Precaución

La configuración tiene 3 capas (MEMORY → RUNTIME → DISK): sin LOAD ... TO RUNTIME no cambia nada, sin SAVE ... TO DISK se pierde al reiniciar. La comprobación de read_only requiere super_read_only=ON en las réplicas; de lo contrario las réplicas se mueven al hostgroup de escritura. Enviar todos los SELECT a las réplicas provoca errores de read-after-write por el lag; es más seguro escribir reglas solo para las consultas pesadas / de informes basándose en stats_mysql_query_digest. La interfaz de administración es SQLite: funciones de MySQL como LEFT() no existen, use substr(). Cambie la cuenta admin:admin por defecto (admin-admin_credentials).