GraphQLの意味

GraphQLは、APIのデータを問い合わせるためのクエリ言語とサーバー側ランタイムです。公式サイトでは、強い型を持つスキーマでデータの関係を定義し、クライアントが必要なフィールドだけを要求できる仕組みとして説明されています。複数の関連リソースを一つのクエリで取得できるため、画面ごとに異なるデータ量が必要なアプリや、複数サービスをまとめるデータ層で使われます。GraphQL APIはURLの集合だけではなく、型、フィールド、リゾルバー、認証、クエリ実行の設計で成り立ちます。スキーマを追加して既存クエリを保ちやすい一方、深いクエリや大量取得を無制限に許すと負荷や情報漏えいのリスクがあるため、深さ制限、コスト計算、認可、キャッシュ、エラー設計を確認します。REST APIをそのまま置き換えるものではなく、既存のRESTやデータベースをGraphQL層から組み合わせる構成も可能です。読み方は「グラフキューエル」です。

GraphQLの背景には、クライアントが必要なデータ項目を指定し、型付きスキーマでデータの関係を扱いたいというAPI設計上の要請があります。公式資料が示すクエリ言語とランタイムの組み合わせとして整理します。

GraphQLは型付きスキーマを使ってAPIへのクエリを扱うため、RESTやデータベースそのものとは区別します。