MariaDB - Replication 복구 (Error 1062 해결 및 Slave 상태 점검)

MariaDB 복제(Replication) 환경에서 종종 발생하는 오류 중 하나가 Error 1062: Duplicate entry입니다.

복제 과정에서 기본 키 중복 문제로 인해 발생하며 복제가 중단되는 상황이 발생할 수 있습니다.

1. Error 1062: Duplicate Entry

주로 Primary Key 값이 중복되어 발생하는 문제입니다. 복제 환경에서는 주로 mysql.gtid_slave_pos 테이블에서 중복된 키로 인해 에러가 발생하는데, 이로 인해 Slave SQL 스레드가 멈추고 동기화가 중단됩니다. 로그를 보면 다음과 같은 에러 메시지를 확인할 수 있습니다:

Error during XID COMMIT: failed to update GTID state in mysql.gtid_slave_pos: 1062: Duplicate entry

 

2. 오류 해결 방법

에러가 발생하면 Slave 서버에서 복제가 중단되므로 이를 복구해야 합니다. 

1. Slave 정지: Slave를 정지합니다.

   STOP SLAVE;

2. 에러 건너뛰기: 에러를 1회 건너뛰기 위해 다음 명령어를 실행합니다.
   

   SET GLOBAL sql_slave_skip_counter = 1;

3. Slave 재시작: 다시 Slave 복제를 시작합니다.

   START SLAVE;

    

4. 상태 확인: 복제 상태가 정상적으로 돌아왔는지 show slave status 명령어로 확인합니다.

   SHOW SLAVE STATUS\G;

복제 상태가 정상으로 돌아오면 Slave_SQL_Running이 YES로 표시되며

Slave는 Master로부터 이벤트를 수신할 준비가 된 상태가 됩니다.

3. show slave status로 복제 상태 확인하기

MariaDB에서 복제 상태를 점검하는 show slave status 명령어는 복제 과정의 여러 지표를 제공합니다. 

• Slave_IO_Running: IO 스레드가 실행되고 있는지 여부를 표시합니다.
• Master_Log_File: Master DB에서 현재 읽고 있는 바이너리 로그 파일을 나타냅니다.
• Read_Master_Log_Pos: IO 스레드가 Master DB의 바이너리 로그 파일에서 마지막으로 읽은 위치입니다.
• Relay_Log_File: Slave DB에서 실행된 릴레이 로그 파일을 나타냅니다.
• Relay_Log_Pos: 릴레이 로그에서 SQL 스레드가 마지막으로 처리한 위치입니다.
• Seconds_Behind_Master: Slave가 Master와 비교했을 때 어느 정도 지연되었는지를 초 단위로 나타냅니다.

이 정보를 통해 복제가 정상적으로 이루어지고 있는지, 추가적인 문제가 있는지를 쉽게 파악할 수 있습니다.

4. 복제 문제의 근본 원인 분석

에러를 건너뛰는 방식은 일시적인 해결책일 뿐, 반복적으로 문제가 발생한다면 근본 원인을 파악하는 것이 중요합니다.

애플리케이션에서 데이터가 중복 삽입되거나 Master와 Slave 간 동기화가 불안정한 경우가 있을 수 있습니다.

이러한 문제가 지속적으로 발생하면 데이터 불일치나 복제 불안정성 문제가 발생할 수 있으므로 GTID 설정이나 복제 재구성 등을 통해 문제의 근본 원인을 해결하는 것이 필요합니다.

5. 결론

MariaDB 복제 환경에서 Error 1062: Duplicate entry 오류는 자주 발생할 수 있지만, 위의 절차를 따르면 쉽게 해결할 수 있습니다. 복제가 정상적으로 작동하는지 지속적으로 모니터링하고, 근본적인 원인 분석을 통해 장기적인 해결책을 마련하는 것이 중요합니다.

복제 오류는 운영 환경에서 민감한 문제이므로, 오류를 무시하기보다는 정확히 문제를 파악하고 해결하는 것이 데이터 일관성을 유지하는 핵심입니다.