GraphQL
GraphQL
GraphQLとは?
- 必要なデータだけを選んで一度にリクエスト
- 過剰・過少レスポンス問題の解決
- RESTの代替手段
GraphQLを導入すると、「どのデータを返すか」を決める権限がサーバーからクライアントへ移ります。RESTでは画面が1つ変わるたびに、フロントエンドがバックエンドに新しいエンドポイントを依頼し、デプロイの日程を待つ必要がありましたが、GraphQLではスキーマで定義されたフィールドの範囲内でクエリを書き換えるだけで、その日のうちに画面が変わります。チーム間の待ち時間がなくなることが、現場で最も早く実感される変化です。その代わり、スキーマを設計し、バージョンを管理する責任が、バックエンドの新しい業務として加わります。
エンドポイントは通常 /graphql の1つで、操作は照会(Query)・変更(Mutation)・リアルタイム購読(Subscription)の3種類に分かれます。RESTと分かれる決定的なポイントはキャッシュです。RESTはURL単位でCDNとブラウザのキャッシュをそのまま使えますが、GraphQLは1つのアドレスにPOSTでやり取りするため、HTTPキャッシュは事実上使えません。Apolloのようなクライアントキャッシュや永続クエリを別途組み込む必要があり、エラーもHTTP 200のレスポンス本文に入って返ってくるため、ステータスコードで障害を検知していた監視は最初から作り直す必要があります。
導入の判断基準は意外とシンプルです。画面1つを描くのにAPIを3〜4個以上続けて呼び出し、Web・iOS・Androidのようにクライアントが3つ以上ある場合に効果が大きいです。反対に、管理画面中心でエンドポイントが20個ほどのサービスなら、RESTの保守コストがはるかに安くすみます。全面的な置き換えではなく、BFF層にだけGraphQLを載せ、既存のRESTを包む折衷案が韓国国内では一般的です。
最もよくある誤解は「一度に受け取れるから必ず速い」という考えです。サーバー内では投稿20件ごとに投稿者を個別に照会するN+1呼び出しがそのまま起きるため、データローダーなしで公開すると、DBの接続がまず尽きます。クライアントがネストの深さを自由に指定できる点も危険で、深さ・複雑度の制限をかけないと、1回のクエリでサーバーが止まってしまいます。権限もURLではなくフィールド単位で検査する必要がありますが、これを見落として年俸や個人の連絡先フィールドがそのまま露出する事故が実際に起きています。
フェイスブックが2012年に社内で開発し、2015年に公開したAPIクエリ言語で、クライアントが必要なデータを正確に要求する方式を標準化しました。
仮想の事例で見てみましょう。役職員320名、年間売上1,800億ウォン(約2,152,621万円)規模のファッションECのA社です。アプリの商品詳細画面を1つ表示するのにREST APIを7回呼び出していたため、ロード時間が平均2.8秒まで伸び、企画が変わるたびにエンドポイントを新たに作る必要があり、デプロイが2週間ずつ遅れていました。CTOが3か月の改善課題を付けました。
- モバイル開発チームのキム・リードがアクセスログを抽出したところ、商品詳細の1画面で呼び出しが7回、LTE環境での平均読み込みは2.8秒、初期画面の離脱率は18%でした。
- バックエンドのパートリーダーが"画面ごとにエンドポイントを掘ると、管理するアドレスが200を超える"と反対したため、既存のRESTは残したまま、BFF層にGraphQLゲートウェイを載せる案でまとめました。
- 最初の4週間は商品・レビュー・在庫の3つのドメインだけをスキーマに移しましたが、レビュー一覧で投稿者を1件ずつ照会するN+1問題が発生したため、データローダーを導入し、DBの呼び出しを50件から3件に減らしました。
- オープンから2週目に提携先の一社がネスト6段階のクエリを投げ、APIサーバーのCPUが92%まで跳ね上がったため、その夜にクエリの深さ5・複雑度1,000の上限と永続クエリを適用しました。
- 3か月後、商品詳細の呼び出しは7回から1回に、平均ロード時間は2.8秒から1.1秒に短縮され、画面修正のためにバックエンドのデプロイを待つ件数は月11件から2件に減りました。
ク・ジャリョン
パク・スンテ