関数の形でもネットワークを越える
gRPCではサービス定義からクライアントやサーバー側のコードを生成し、メッセージを使って遠隔の手続きを呼び出します。Protocol Buffersは一般的な定義・符号化の選択肢です。ただし、見た目がローカルのメソッド呼び出しに近くても、接続、転送、サーバー実行、応答の返送という複数の段階があります。ローカル変数を読むような失敗のない一操作として扱うと、タイムアウト後の再実行などで不具合を生みます。型の共有は、通信成功や業務上の一回性の保証とは別です。
四つの呼び出しの形
一つの要求に一つの応答を返すunaryのほか、サーバーストリーミング、クライアントストリーミング、双方向ストリーミングがあります。例えば検索条件を一度送り、検索結果を順に受け取るのはサーバーストリーミングの形です。双方向ストリーミングでも、双方のメッセージが一対一で交互に対応するとは限りません。各方向の順序と、アプリケーションがどの応答をどの要求に対応付けるかは区別します。メッセージを小さくしただけで、消費側の速度制限がなくなるわけでもありません。
deadlineを予算として伝える
画面の要求全体で1秒を使えるとき、下流RPCへ残り時間を考えず1秒ずつ与えると、合計時間が意図より長くなります。deadlineは呼び出しがいつまでに終わるべきかを表すため、残りの予算を考えて設定します。期限超過やキャンセルが伝わっても、実行済みのデータ更新が自動で巻き戻るわけではありません。サーバー側もキャンセル状態を確認し、不要になった処理を止める必要があります。待つ時間の制限と、処理の副作用の取り消しを同じものとして設計しないことが大切です。
失敗の分類と再試行
在庫を一つ減らすRPCを送り、サーバーが更新した直後に応答が失われたとします。クライアントのエラーだけでは、更新前に失敗したのか、更新後の返送で失敗したのかを区別できません。安全な再試行には要求IDなどによる重複排除や、処理結果の再取得を含む設計が必要です。gRPCのステータスと、業務上の成功・失敗も分けて扱います。暗号化、利用者の認証、操作ごとの認可、スキーマの互換性は、それぞれ別に確認する責務として残ります。