こんにちは！Redisの奥深い世界へようこそ。
今日は、多くのエンジニアが一度は冷や汗をかく「AOFファイルの破損」と、それを鮮やかに救い出す裏技ツール`redis-check-aof`についてお話しするね。
ここをしっかりとクリアできれば、あなたのRedis運用スキルは一段とプロに近づきます。難しい専門用語はなるべく使わずに、日常のたとえ話を交えながら優しく解説していくから、リラックスしてついてきてくださいね！
—
1. Redisの「メモ帳」：AOFファイルの正体
まず、Redisがデータをどうやって覚えているかのお話から。
Redisは、超高速にデータを読み書きするために、すべてのデータをパソコンの「メモリ（RAM）」という場所に広げて作業しています。メモリは電気が消えると中身がすべて消えてしまう「儚い記憶」の持ち主。
だから、Redisは「これまでに行った操作の歴史」を、まるで日記帳のように一文字残らずノートに書き留めています。
このノートのことを、Redisの世界ではAOF（Append Only File）と呼んでいます。
- 日常のたとえ：お会計のレシート
レジの横で、お客さんが買った商品を「りんご1個」「牛乳1本」と1行ずつメモしていくノートを思い浮かべてください。万が一、お店が停電してレジが壊れても、このノートの記録を最初から順番に読み直せば、レシーの総額を完璧に復元できますよね。RedisのAOFも、これとまったく同じことをやっているんです。
—
2. なぜ、その「ノート」が破れてしまうのか？
非常に頼りになるAOFノートですが、たまに悲劇が起きます。
例えば、Redisがまさにノートに文字を書き込んでいる真っ最中に、サーバーの電源がプチッと切れてしまったり、ディスクの容量がパンパンになってしまったりしたとき。
ノートの最後が、こんな風に中途半端な状態でプツッと途切れてしまうんです。
SET user:101 “Taro”
HSET user:101:profile age 28
APPEND user:101:profile “Tokyo”
SET user:102 “Hanako”
SET user:103 “Jiro” <-- ここで急に電源が落ちて
SET user:104 "Sabur <-- 文字が途中で途切れている！
この「中途半端にちぎれたノート」を持ったままRedisを再起動しようとすると、Redisはこう言います。
「おいおい、最後の行の文字が途中で途切れていて読めないよ！安全のためにお仕事ストップします！」
これが、本番環境でよくある「AOFファイルの破損による起動失敗」の正体です。さあ、どうしよう？
—
3. 救世主登場：`redis-check-aof` という名の消しゴム
ここで登場するのが、今回の主役である `redis-check-aof` というコマンドラインツールです。
こいつの仕事は非常にシンプルかつ強力。
「壊れたノートを隅々まで診断し、読めないところ（壊れた末尾の部分）を綺麗にハサミで切り落として、読み込める状態に戻す」 ことです。
- 日常のたとえ：ページ破れの処置
ノートの最後のページにインクが盛大に垂れてぐちゃぐちゃになっていたら、その部分だけを綺麗に切り取って、その手前の「読める正常な記録」までを生かしてノートを閉じますよね。`redis-check-aof` は、まさにその手当を秒速で行ってくれる名医なんです。
—
4. 実践！`redis-check-aof` の使い方
もし実際に「Redisが起動しない！」というピンチに出会ったら、慌てずに以下のステップを踏みましょう。
ステップ1：現状の確認と診断
まずは、本当にAOFファイルが壊れているのかを、このツールに診断させます。ターミナル（黒い画面）を開いて、次のように打ち込んでみてください。
–fix をつけずに実行すると、まずは「診断（健康診断）」だけをしてくれます
redis-check-aof appendonly.aof
実行結果のイメージ：
06:00:00 診断を開始します…
06:00:00 AOFファイルの読み込み中…
06:00:01 E 壊れたバイトを検知しました！オフセット 104523 番地以降が破損しています。
06:00:01 F 致命的なエラー：AOFファイルは正常ではありません。
「あ、やっぱり最後のほうが壊れているな」と分かります。
ステップ2：痛みを伴う治療（ファイルの切り詰め）
いよいよ修復です。お医者さんに「ここから先を切り落としてください」とお願いします。末尾に `–fix` という魔法の呪文をつけましょう。
–fix オプションをつけると、壊れた末尾を自動でカットしてくれます
redis-check-aof –fix appendonly.aof
実行すると、ツールがこう優しく聞いてくれます。
> `Are you sure you want to truncate the AOF file? [y/N]`
> （本当にAOFファイルを切り詰めてもよろしいですか？）
ここで深呼吸して、キーボードで `y` （Yes）を叩いてEnterを押します。
実行結果のイメージ：
Successfully truncated AOF
このメッセージが出たら大成功！壊れていた末尾の数行（または数バイト）が潔く切り落とされ、ファイルは「最後まで綺麗に読める状態」に生まれ変わりました。
ステップ3：Redisの再起動
お医者さんの治療が終わったので、Redisをもう一度起動してみましょう。
お使いの環境に合わせてRedisを起動（例：systemctlを使う場合）
sudo systemctl start redis
無事に「スッ…」と何事もなかったかのようにRedisが起動するはずです。
—
5. 先輩エンジニアからの大切なアドバイス（知っておくべき現実）
ここで一つ、冷静で大切な現実をお伝えしておかなければなりません。
`redis-check-aof –fix` は「読めない部分を切り捨てる」ツールです。つまり、「電源が落ちるまさにその瞬間、書き込まれようとしていた最新の数件のデータ」は、泣く泣く諦めて消去されることになります。
- データのロスト（消失）について
100万件のデータのうち、最後の最後に書き込んでいた数件だけが消える代わりに、残りの99万9995件の貴重なデータと、サービス全体の稼働を守るための処置です。「全部失うリスク」に比べれば、「最後のわずかなカスを諦める」のは、システム運用において非常に賢明なトレードオフ（選択）なのです。
もちろん、これを防ぐためには日頃からサーバーの電源周りを安定させたり、定期的なバックアップを取ったりすることが大切ですが、万が一の事故の際には、この `redis-check-aof` があなたの最強の相棒になってくれます。
—
まとめ
- AOF は、Redisがこれまでの操作をコツコツ書き留めた「日記帳（レシート）」。
- サーバーの強制終了などで、AOFの末尾が破損してRedisが起動しなくなることがある。
- そんなときは `redis-check-aof –fix` を使えば、壊れた末尾を綺麗に切り落として復活させられる。
- 切り落とした分の直近のデータは消えてしまうが、システム全体を救うための心強い処置である。
ここをマスターしておけば、いざという時に「あ、焦らなくてもあのツールで直せるな」と冷静に対処できるようになります。
Redisの運用において、ピンチをチャンスに変えるこのテクニック、ぜひ頭の片隅に置いておいてくださいね。
あなたのエンジニアライフが、もっと楽しく、もっと安心なものになりますように！
コメント