AppSyncでは、GraphQL APIとEvent APIの2種類のAPIを作成・実行することができます。
今回は、AppSyncのGraphQL APIの方について、大まかな仕組みを説明します。

この記事で書くことと書かないこと

この記事で書くこと

・GraphQL APIでデータを読み込むときの、ざっくりした仕組み

この記事で書かないこと

・詳細なサービス設定や使用言語の書き方
・GraphQL APIでデータを読み込むとき以外の仕組みについて

GraphQL APIが実行されるまでの仕組み

たとえば、お料理のレシピを検索したり、データベース（以下、DB）に登録できるアプリケーションがあるとします。
まずは、データのIDを指定して特定のデータを検索する getRecipe 処理を例にとって仕組みを説明します。

全体の構造

要素の説明

Schema(スキーマ)
　　・APIの処理で使うデータ構造の倉庫。
　　・リゾルバは、このスキーマ内で定義された項目名と一致する項目名をDBから探してデータを取得する。
　　・AWSマネージメントコンソール > AWS AppSync > 作成したAPI > Schema から設定できるリソースのこと。

type Query
　　・スキーマ内の要素の１つで、読み取り処理（のデータ構造）を宣言する場所。

※ちなみに、GraphQL の type は複数種類あり、
・Query：データの読み取り
・Mutation：データの作成・更新・削除
・Subscription：リアルタイム購読
を意味します。
今回の例は「Query（読み取り）」に該当します。

API(GraphQL API)
　　・AppSyncが提供するAPIリソースのこと。
　　・Create API から作成できる。

Resolver(リゾルバ)
　　・API内で特定の処理を実行するためのリソース。
　　・どのAPI（の処理）を、どのデータソース(DBとか)からデータを引っ張ってくるかを設定する。
　　・作成したAPI > Schema > Resolvers から作成できる。

DB
データを取得するデータベース

仕組み

GraphQLでは、スキーマがAPIの設計図、リゾルバが実際の処理ロジック、データソースが実データの置き場所を担っています。
つまり、AppSyncはこの3つを紐づけることで「GraphQLクエリ → 実データ取得」までの流れを構築しています。

まず、重要な登場人物がリゾルバです。
スキーマで定義したとおりに、データソースからデータを取得する処理を実際に行うのがリゾルバ。というイメージです。
なので、実装時にはリゾルバとスキーマ、データソースをそれぞれ紐づけてあげる必要があります。

1. スキーマとリゾルバを紐づける

スキーマ内のどのデータ構造を使ってデータソースにアクセスするかを、リゾルバのフィールドに指定します。
以下の図のように、Shcema > type Query 内に記載のフィールド名と一致する必要があります。
以下の図の例では、getRecipe (IDを指定して該当のデータを取得する)を実行して、DBからデータをとってくる設定をしています。

実際に画面上から設定するときは、Schema > Resolvers 内のフィールド横の「Attach」ボタンを押下する操作になります。

2. リゾルバとデータソースを紐づける

同時に、どのデータソース（今回の場合はDB）へアクセスするかを、リゾルバのデータソースに指定します。
以下の図のように、データソース名がと一致する必要があります。

実際に画面上から設定するときは、Schema > Resolvers 内のフィールド横の「Attach」ボタン > Attach resolver からデータソースを設定します。

3. 実行結果

作成したAPI > Queries から、IDを指定して getRecipe を実行します。
すると、指定したDBからデータを取得できます。

おわりに

今回はDBからデータを検索する例で仕組みを説明しましたが、
・DB以外にも、AWS LambdaやAmazon EventBridgeとも連携して別の処理を呼び出すこともできます
・スキーマ内の type Query ではなく type Mutation をリゾルバのフィールドに指定することで、書き込み処理もできます