Mettre en place une réplique (CHANGE REPLICATION SOURCE)

Commande

CHANGE REPLICATION SOURCE TO SOURCE_HOST='source_host', SOURCE_PORT=3306, SOURCE_USER='replicator', SOURCE_PASSWORD='secret', SOURCE_AUTO_POSITION=1;

Ce que fait la commande

Configure ce serveur comme réplique suivant la source indiquée avec l'auto-positionnement basé sur GTID.

Quand l'utiliser

Pour mettre en place une nouvelle réplique ou changer la source de réplication.

Attention

Il s'agit de la terminologie MySQL 8.0.23+ ; les versions plus anciennes utilisent CHANGE MASTER TO ... MASTER_HOST (alias en 8.0.23–8.3, supprimé en 8.4). SOURCE_AUTO_POSITION=1 exige que GTID soit activé (gtid_mode=ON) ; sinon SOURCE_LOG_FILE et SOURCE_LOG_POS doivent être indiqués. La réplication doit être arrêtée avant d'exécuter la commande. Si l'utilisateur de réplication a été créé avec caching_sha2_password, défaut en 8.0+, la connexion exige TLS : ajoutez SOURCE_SSL=1 ou, sans TLS, définissez GET_SOURCE_PUBLIC_KEY=1 ; sinon le thread I/O ne parvient pas à se connecter et renvoie l'erreur 2061.