gRPCとは?Protocol Buffersベースの高速RPC・REST APIとの違いを解説

gRPCとは? ― Googleが生んだ高速リモートプロシージャコール

gRPC(gRPC Remote Procedure Call)とは、Googleが開発したオープンソースの高性能RPCフレームワークです。HTTP/2をトランスポート層に使い、Protocol Buffers(protobuf)をデフォルトのシリアライゼーション形式として採用することで、REST APIよりも高速かつ効率的なサービス間通信を実現します。

電話会議に例えると、REST APIが「手紙のやり取り」(テキストベースのJSON)だとすれば、gRPCは「内線電話」(バイナリ形式の直接通信)です。手紙は誰でも読めますが時間がかかります。内線電話は即座につながり、社内用語(protobuf)で効率よく伝達できますが、外部との通信には向きません。

gRPCを支える3つの技術要素

1. Protocol Buffers(protobuf)
protobufは、構造化データをバイナリ形式でシリアライズするための仕組みです。.protoファイルにデータ構造とサービスインターフェースを定義すると、各言語のクライアント・サーバーコードが自動生成されます。JSONと比較して、データサイズは約3〜10分の1、シリアライズ速度は約5〜10倍高速です。

2. HTTP/2
gRPCはHTTP/2の機能をフル活用します。1つのTCPコネクション上で複数のリクエスト・レスポンスを同時に処理(多重化)でき、ヘッダー圧縮によるオーバーヘッド削減、サーバープッシュによる効率的なデータ送信が可能です。

3. IDL(Interface Definition Language)ベースの設計
.protoファイルがサーバーとクライアントの「契約書」となり、APIの仕様が明確に定義されます。これにより、異なるプログラミング言語間でも型安全な通信が保証されます。

gRPCの4つの通信パターン

gRPCはRESTにはない柔軟な通信パターンを提供します。

パターン 説明 ユースケース
Unary(単項) 1リクエスト → 1レスポンス。REST APIと同じ形式 ユーザー情報の取得、認証処理
Server Streaming 1リクエスト → 複数レスポンスをストリームで返却 リアルタイムの株価配信、ログのストリーミング
Client Streaming 複数リクエストをストリームで送信 → 1レスポンス 大容量ファイルのアップロード、センサーデータの一括送信
Bidirectional Streaming 双方向にストリームを同時送受信 チャット、リアルタイムゲーム、音声通話

gRPC vs REST API ― どちらを選ぶべきか

比較項目 gRPC REST API
データ形式 Protocol Buffers(バイナリ) JSON(テキスト)
プロトコル HTTP/2 HTTP/1.1(HTTP/2も可能)
パフォーマンス 高速(バイナリ+多重化) gRPCより遅い(テキスト解析のオーバーヘッド)
ブラウザ対応 直接対応不可(grpc-webが必要) ネイティブ対応
可読性 バイナリのため人間が直接読めない JSONは人間が読みやすい
ストリーミング 双方向ストリーミングをネイティブサポート SSEやWebSocketで別途実装が必要
エコシステム 成長中。ツールは増えているが、RESTほどは充実していない 非常に成熟。豊富なツールとドキュメント

結論として:マイクロサービス間の内部通信にはgRPCが適しています。一方、外部公開API(ブラウザやサードパーティ向け)にはRESTが依然として有力です。多くの企業では、内部通信はgRPC、外部APIはRESTというハイブリッド構成を採用しています。

gRPCの実践的な導入ステップ

ステップ1:.protoファイルの設計
サービスのメソッドとメッセージ型を.protoファイルに定義します。この設計がAPI全体の品質を左右するため、チーム間でレビューを行いましょう。

ステップ2:コード生成
protocコンパイラで.protoファイルから各言語のスタブコードを生成します。Go、Java、Python、Node.js、C#など10以上の言語に対応しています。

ステップ3:サーバー実装
生成されたインターフェースを実装し、ビジネスロジックを記述します。フレームワークが接続管理やシリアライゼーションを処理するため、ロジックに集中できます。

ステップ4:テストとデバッグ
grpcurl(gRPC版のcurl)やBloomRPC、Postman(gRPC対応)を使って動作確認を行います。

よくある質問(FAQ)

Q. gRPCはブラウザから直接呼べますか?
A. 標準のgRPCはブラウザから直接呼べません。grpc-webというプロキシ経由のプロトコルを使うか、APIゲートウェイでgRPCをRESTに変換する方法があります。Envoyプロキシがgrpc-webの変換に対応しています。

Q. Protocol Buffersの代わりにJSONを使えますか?
A. 技術的には可能です(gRPCはJSONエンコーディングもサポート)。ただし、protobufのパフォーマンスと型安全性の恩恵を失うため、特別な理由がない限りprotobufを使うことが推奨されます。

Q. gRPCのエラーハンドリングはどうなっていますか?
A. gRPCは独自のステータスコード体系(OK、NOT_FOUND、INTERNAL、DEADLINE_EXCEEDEDなど16種類)を持っています。HTTPステータスコードとは異なりますが、APIゲートウェイでの変換が可能です。

まとめ

gRPCは、Protocol BuffersとHTTP/2を基盤とした高性能なRPCフレームワークです。マイクロサービス間の内部通信において、RESTを大きく上回るパフォーマンスと型安全性を提供します。双方向ストリーミングやコード自動生成も強力な武器です。ただし、ブラウザ対応の制限やバイナリ形式ゆえのデバッグの難しさを理解した上で、RESTとの使い分けを判断することが重要です。

コメント