【入門編】 redis.pcall関数 – Redis

こんにちは！ Redisの奥深い世界へようこそ。
今日は、Redisの中で動く小さなプログラム「Lua（ルア）スクリプト」の隠れた名優、`redis.pcall`（ピー・コール）についてお話しします。

「エラーハンドリング？例外？なんか難しそう……」と思ったそこのあなた、大丈夫です。今日は専門用語を極力使わず、私たちの日常のちょっとした「おつかい」に例えて優しく解きほぐしていきますね。

ここをクリアすれば、Redisを使いこなすワンランク上のエンジニアにグッと近づけますよ。肩の力を抜いて、一緒に見ていきましょう！

—

1. レストランの「注文係」で例える `redis.call` の世界

まずは、普段よく使われる `redis.call`（コール）のお話から。

イメージしてください。あなたはファミレスのキッチンで働く料理人です。ホールにいる「注文係（Redis）」に、「お客さんのテーブルからお皿を下げて！」と指示を出します。

ふつうはこれで上手くいきます。でも、もしそのテーブルにお皿がなかったらどうでしょう？
注文係はパニックになって、「大変です！お皿がありません！」と大声で叫び、その場で仕事ストップ！全体の業務がその瞬間で凍りついてしまいます。

これが、`redis.call` の動きです。エラーが起きたら、そこで容赦なくプログラム全体が止まってしまうんですね。

2. トラブルを華麗にいなすプロの技 `redis.pcall`

ここで登場するのが、今回の主役である `redis.pcall` です。頭の「p」は、英語の「Protected（守られた）」の頭文字だとイメージしてください。

もしあなたがベテランの料理人なら、注文係が「お皿がありません！」と飛び込んできても、慌てずこう言うはずです。
「あ、そう。じゃあ別のお皿を用意して、お客さんにはお待たせしてすみませんって伝えておいて」

このように、失敗したときにパニックを起こさず、「おっと、エラーが起きたぞ。じゃあ次はこうしよう」と自分で後始末（エラーハンドリング）ができるのが、`redis.pcall` の最大の強みです。

—

3. 実際のコードで見てみよう

百聞は一見にしかず。実際にRedisの中でどう動くのか、コードを見てみましょう。
（※Redisの中では、複数の命令をまとめて実行するためにLuaというシンプルな言語を使います）

例えば、「存在しないデータを無理やり読み込もうとした」と仮定します。

— 【実験1】redis.call の場合（エラーで即ストップ）
local result = redis.call(“GET”, “non_existent_key”)
— もしここでエラーが起きると、この下の行には絶対にたどり着きません！
return “この処理は実行されません”

`redis.call` だと、エラーが出た瞬間にゲームオーバー（処理中断）になります。

では、`redis.pcall` に変えてみましょう。

— 【実験2】redis.pcall の場合（エラーをキャッチして優しく受け止める）
local status, result = pcall(function()
return redis.call(“GET”, “non_existent_key”)
end)

— 正確にはRedisでは以下のようにテーブル（結果の箱）で返ってきます
local response = redis.pcall(“GET”, “non_existent_key”)

— エラーが起きたかどうかを「返り値の箱」で確認できます
if type(response) == “table” and response.err then
— 「あ、エラーだったんだな」と自分で気づいて別の手を打てる！
return “おっと、データが無かったので、代わりにデフォルト値を返します！”
else
return response
end

`redis.pcall` は、エラーが起きてもプログラムを止めず、「エラーの内容」というデータ（お土産）をこっそり持って帰ってきてくれるのです。

—

4. どんなときに使うの？（実務での使いどころ）

「エラーが起きても止まらない」という性質は、どんな場面で役に立つのでしょうか？

それは、「失敗するかもしれない一連の作業を、途中で止めずに最後までやりきりたいとき」です。

複数のデータを同時に更新したいけれど、途中で1つ失敗しても、他のデータの処理は続けたいとき
「失敗したら自動で別の予備ルートに切り替える（フォールバック）」という安全装置を作りたいとき

例えるなら、車を運転していて突然のパンク（エラー）に直面したとき、急ハンドルを切って横転する（`redis.call`）のではなく、ハザードを出して路肩に安全に寄せる（`redis.pcall`）ようなものです。システムの「安全性」と「優しさ」をグッと高めてくれます。

—

まとめ：Redisの基本はこれでバッチリ！

お疲れ様でした！最後に今日の内容をギュッとまとめますね。

`redis.call`: エラーが起きたら即座にストップ！厳格な処理に向いている。
`redis.pcall`: エラーが起きても止まらず、エラーの情報をこっそり教えてくれる。自分で後始末ができる。

「失敗を恐れない」のではなく、「失敗しても上手に立て直せる仕組みを作る」。これが、優れたエンジニアが書く堅牢なコードの秘密です。

ここをクリアできたあなたなら、Redisのスクリプト機能の怖さはもう無いはずです。ぜひ実際の環境で試して、エラーを華麗にいなす快感を味わってみてくださいね。あなたのエンジニアライフを、心から応援しています！