Aurora MySQL에서 binlog 보존 시간을 확인·설정하는 방법

この文書の適用条件

そのまま実行できるコマンド

-- 対象: Aurora MySQL 2.x / 3.x
-- 権限: mysql スキーマのストアドプロシージャ実行権限（通常はマスターユーザー）
-- 変更作業: なし（参照のみ）
-- Production 実行: 可能
CALL mysql.rds_show_configuration;

-- 対象: Aurora MySQL 2.x / 3.x
-- 権限: 接続権限（グローバル変数の参照のみ）
-- 変更作業: なし（参照のみ）
-- Production 実行: 可能
SELECT
    @@global.log_bin           AS log_bin_enabled,
    @@global.binlog_format     AS binlog_format,
    @@global.binlog_row_image  AS binlog_row_image,
    @@global.binlog_checksum   AS binlog_checksum;

-- 対象: Aurora MySQL 2.x / 3.x（ライターインスタンス）
-- 権限: REPLICATION CLIENT 権限
-- 変更作業: なし（参照のみ）
-- Production 実行: 可能

-- 1) 現存するbinlogファイルとサイズ
SHOW BINARY LOGS;

-- 2) 現在の書き込み位置（Aurora MySQL 3.x の一部バージョンでは
--    SHOW BINARY LOG STATUS に置き換えられているため、エラーになる場合はそちらを使う）
SHOW MASTER STATUS;

-- 対象: Aurora MySQL 2.x / 3.x
-- 権限: RDSのマスターユーザー相当（一般ユーザーではアクセス拒否になる）
-- 変更作業: あり（binlog の保持時間ポリシーを変更する）
-- Production 実行: 可能。ただしストレージ消費が増えるため事前に見積もること

-- 保持時間は「時間」単位で指定する（例: 24時間）
CALL mysql.rds_set_configuration('binlog retention hours', 24);

-- 設定後の値を確認する
CALL mysql.rds_show_configuration;

-- 明示設定を解除して既定の挙動（早期削除）に戻す場合
-- CALL mysql.rds_set_configuration('binlog retention hours', NULL);

# 対象: Aurora MySQL（DBクラスターパラメータグループ）
# 権限: IAM rds:ModifyDBClusterParameterGroup, rds:RebootDBInstance
# 変更作業: あり（クラスターパラメータ変更 + ライターインスタンス再起動）
# Production 実行: 不可（再起動を伴うためメンテナンス時間帯に計画実行）

# 1) 現在値と反映方法を確認する
aws rds describe-db-cluster-parameters \
  --db-cluster-parameter-group-name example-aurora-mysql-cluster-params \
  --query "Parameters[?ParameterName=='binlog_format' || ParameterName=='binlog_row_image'].{Name:ParameterName,Value:ParameterValue,Apply:ApplyType}" \
  --output table

# 2) binlog_format を ROW に変更する（クラスター単位のパラメータ）
aws rds modify-db-cluster-parameter-group \
  --db-cluster-parameter-group-name example-aurora-mysql-cluster-params \
  --parameters '[
    {"ParameterName":"binlog_format","ParameterValue":"ROW","ApplyMethod":"pending-reboot"}
  ]'

# 3) ライターインスタンスを再起動して反映する（接続断が発生する）
aws rds reboot-db-instance --db-instance-identifier example-aurora-instance

-- 対象: Aurora MySQL 2.x / 3.x（ライターインスタンス）
-- 権限: MySQL 8.0互換は BINLOG_ADMIN、5.7互換は SUPER 相当（RDSではマスターユーザー）
-- 変更作業: あり（binlog ファイルを削除する。削除したログは復元できない）
-- Production 実行: 原則不可。全ての消費側の読み取り位置を確認してからのみ実施する

-- 1) 先に消費側（レプリカ・DMS・CDC）がどこまで読んでいるかを確認する
SHOW BINARY LOGS;

-- 2) 指定ファイルより前のbinlogを削除する
PURGE BINARY LOGS TO 'mysql-bin-changelog.000123';

-- 3) 日時指定で削除する場合
-- PURGE BINARY LOGS BEFORE '2026-08-01 00:00:00';

結果の読み方

こういう状況で使います

• DMS의 CDC 작업이 "binlog를 찾을 수 없음" 계열 오류로 중지됨
• 외부 레플리카를 한 번 멈췄다가 재개했더니 따라잡지 못하고 오류가 발생함
• binlog를 활성화한 후 클러스터의 스토리지 사용량이 계속 증가함
• `CALL mysql.rds_set_configuration(...)`를 실행했더니 접근 거부됨
• DMS의 엔드포인트 테스트에서 binlog 설정 관련 경고가 발생함

考えられる原因（可能性の高い順）

1. 01

   보존 시간이 명시적으로 설정되지 않음

   `binlog retention hours`가 `NULL`인 경우 RDS는 불필요하다고 판단한 binlog를 조기에 삭제합니다. CDC 소비 측이 일시 중단되면 재개 시 필요한 binlog가 이미 없을 수 있습니다.

2. 02

   보존 시간이 소비 측의 중단 시간보다 짧음

   소비 측(DMS 작업, 외부 레플리카)이 유지보수나 장애로 멈추는 시간보다 보존 시간이 짧으면 재개 시 따라잡을 수 없습니다. 허용 중단 시간을 역산하여 설정해야 합니다.

3. 03

   `binlog_format`이 `ROW`로 설정되지 않음

   `STATEMENT`나 `MIXED`에서는 CDC가 필요로 하는 행 단위 변경 내용을 가져올 수 없습니다. Aurora에서는 클러스터 파라미터 그룹에서 설정합니다.

4. 04

   실행 사용자에게 RDS 마스터 사용자 수준 권한이 없음

   `mysql.rds_set_configuration`은 RDS가 제공하는 저장 프로시저로, 실행에는 마스터 사용자 수준 권한이 필요합니다. 애플리케이션용 일반 사용자로는 접근이 거부됩니다.

5. 05

   수동 `PURGE BINARY LOGS`로 필요한 로그를 삭제함

   소비 측이 아직 읽지 않은 파일을 삭제하면 복구할 수 없습니다. 스토리지 부족 시의 임시 대응으로 실행되어 나중에 발견되는 경우가 있습니다.

6. 06

   장애 조치(failover)로 쓰기 대상이 전환됨

   라이터가 전환되면 binlog 파일명과 위치의 연속성을 소비 측이 어떻게 처리하는지가 문제가 됩니다. CDC 쪽의 재개 방식을 확인하십시오.

確認手順

1. 1

   보존 시간의 현재 값 확인하기

   参照のみ

   `CALL mysql.rds_show_configuration;`을 실행해 `binlog retention hours` 값을 확인합니다. 조회만 하므로 안전합니다.

2. 2

   binlog가 활성화되어 있고 ROW 형식인지 확인하기

   参照のみ

   `@@global.log_bin`과 `@@global.binlog_format`을 조회합니다. `binlog_row_image`도 함께 확인합니다.

3. 3

   현존하는 binlog의 범위와 총 크기 확인하기

   参照のみ

   `SHOW BINARY LOGS`로 가장 오래된 파일과 총 크기를 봅니다. 보존 시간을 늘리기 전의 추정에도 사용할 수 있습니다.

4. 4

   소비 측의 읽기 위치와 지연 확인하기

   参照のみ

   DMS라면 작업의 CDC 지연 메트릭, 외부 레플리카라면 레플리카 측 상태로 어디까지 읽었는지 확인합니다.

5. 5

   CloudWatch에서 스토리지 사용량 추이 확인하기

   参照のみ

   보존 시간을 늘렸을 때의 증가분을 실제 추이에서 추정합니다.

6. 6

   실행 사용자의 권한 확인하기

   参照のみ

   `SHOW GRANTS;`로 `mysql.rds_set_configuration`을 실행할 수 있는 사용자인지 확인합니다.

対応方法

バージョン・環境による違い

これで解決しない場合に確認すること

• CDC 소비 측의 재개 위치 보존 방식 확인하기

  DMS나 레플리카가 읽기 위치를 어디에 저장하고 장애 조치 후 어떻게 재개하는지 확인합니다.

• 클러스터 스토리지 사용량 추이 확인하기

  binlog뿐만 아니라 임시 영역이나 스냅샷도 포함해 증가 요인을 구분합니다.

• 백업 보존 기간과의 관계 정리하기

  binlog 보존과 백업 보존은 별개의 설정입니다. 복구 요구사항에 대해 어느 쪽이 어디까지 영향을 주는지 정리하십시오.

• 마스터 사용자 관리 방법 확인하기

  마스터 사용자의 자격 증명 보관과 사용 절차를 정해두지 않으면 필요할 때 설정 변경을 할 수 없습니다.

• binlog를 읽는 소비 측 목록 만들기

  DMS, 외부 레플리카, 변경 알림 체계 등 binlog에 의존하는 것들을 미리 찾아두면 보존 시간 판단이 빨라집니다.

この文書の根拠と限界

よくある質問

この文書がカバーする質問

• rds_set_configuration에서 권한 오류가 발생함
• DMS의 CDC에서 binlog를 찾을 수 없다는 오류가 발생함
• Aurora MySQL에서 binlog를 활성화하고 싶다
• binlog가 스토리지를 압박하고 있음

リスク表示の意味

• 参照のみデータと設定を変更しません。
• 低影響は限定的ですが、権限と負荷の確認が必要です。
• 中性能・ロック・コストに影響する可能性があります。
• 高障害・データ損失・復旧作業が発生する可能性があります。
• 専門家レビュー必須本番適用前に別途レビューが必須です。

GIIPの対応範囲

binlog 보존 시간은 "한 번 설정하면 잊어버리는" 설정이 되기 쉽지만, 실제로는 CDC 소비 측의 구성이 바뀔 때마다 적정성이 달라집니다. GIIP에서는 보존 시간 설정값·현존 binlog의 총 크기·CDC 쪽의 지연을 같은 화면에서 추적할 수 있게 하고, 지연이 보존 시간에 근접한 단계에서 알림이 가도록 하고 있습니다. binlog 삭제나 `binlog_format` 변경처럼 되돌릴 수 없는 작업은 자동화 대상에서 제외하고 반드시 사람의 승인을 거치는 설계로 되어 있습니다.

関連サービス

• AWSマネージド運用の範囲を確認する
• 24時間監視の対象を確認する