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';