[MySQL] SHOW BINLOG EVENTS 문 완벽 가이드: 바이너리 로그 이벤트 분석하기

 

 

SHOW BINLOG EVENTS란?

MySQL에서 SHOW BINLOG EVENTS는 바이너리 로그 파일에 기록된 이벤트를 조회할 수 있는 명령어입니다. 이 명령어는 주로 레플리케이션 문제를 분석하거나, 특정 트랜잭션이 어떻게 처리되었는지를 확인할 때 사용됩니다.

바이너리 로그는 데이터 변경(INSERT, UPDATE, DELETE 등) 이력을 기록하는 MySQL의 핵심 기능이며, 마스터-슬레이브 복제(replication)의 기반이 되는 중요한 자료입니다.

---

기본 사용법과 주요 옵션

기본적인 문법은 다음과 같습니다:

SHOW BINLOG EVENTS [IN 'log_name'] [FROM pos] [LIMIT [offset,] row_count];

• IN 'log_name': 조회할 바이너리 로그 파일 이름 지정 (예: 'mysql-bin.000001')
• FROM pos: 특정 위치부터 이벤트 조회 시작 (기본은 4)
• LIMIT: 출력할 이벤트 개수 제한 (페이징 처리에 유용)

예제:

SHOW BINLOG EVENTS IN 'mysql-bin.000001' FROM 120 LIMIT 10;

이 명령은 mysql-bin.000001 로그 파일의 120번째 포지션부터 10개의 이벤트를 출력합니다.

---

출력 결과 해석하기

출력 결과는 다음과 같은 컬럼을 포함합니다:

• Log_name: 로그 파일 이름
• Pos: 이벤트 위치 (바이너리 로그에서의 바이트 오프셋)
• Event_type: 이벤트 종류 (Query, Write_rows, Update_rows 등)
• Server_id: 이벤트를 기록한 서버 ID
• End_log_pos: 해당 이벤트가 끝나는 위치
• Info: SQL 문이나 부가 정보

특히 Event_type과 Info 컬럼은 트랜잭션 내용을 파악하는 데 중요합니다. 예를 들어, Query 이벤트의 Info에 실제 실행된 SQL이 포함되어 있습니다.

---

MySQL 버전별 변화 및 주의사항

• MySQL 5.6부터 GTID 기반 복제를 지원하면서, 바이너리 로그에 GTID 관련 이벤트(GTID, ANONYMOUS_GTID 등)가 추가되었습니다.
• MySQL 8.0 이상에서는 기본적으로 바이너리 로그 포맷이 ROW로 설정되어 있어, Query 이벤트보다는 Write_rows, Update_rows, Delete_rows와 같은 행 기반 이벤트가 주로 나타납니다.
• SHOW BINLOG EVENTS는 현재 슬레이브 서버에서는 동작하지 않으며, 마스터 서버에서만 사용 가능합니다.

---

결론 및 실무 팁

SHOW BINLOG EVENTS는 MySQL에서 데이터 변경 이력을 직접 확인할 수 있는 매우 강력한 도구입니다. 복제 오류 분석, 트랜잭션 추적, 이상 데이터 원인 분석 등에 유용합니다.

실무 팁:

1. 바이너리 로그 포맷에 따라 해석 방식이 다릅니다. STATEMENT vs ROW 포맷을 확인하세요.
2. mysqlbinlog 유틸리티를 함께 사용하면 로그 분석이 더 유연해집니다.
3. 보안상 민감한 데이터가 로그에 포함될 수 있으니 접근 권한을 주의 깊게 설정하세요.

---

공식 문서 링크:
MySQL SHOW BINLOG EVENTS - 공식 문서