GraphQL APIを簡単に作成 & 運用。AWS AppSync をグラレコで解説

アプリケーション開発が加速できるという理由から、各組織では API の構築に GraphQL を選択しています。この API により、フロントエンドのデベロッパーは、複数のデータベースやマイクロサービス、そして API に対し、単一の GraphQL エンドポイントから迅速にクエリができるようになります。

AWS AppSync は、GraphQL API の開発を容易にする、フルマネージド型サービスです。このサービスは、AWS DynamoDB や Lambda、その他のデータソースとの安全な接続に必要な、面倒な作業を自動的に処理します。パフォーマンスを向上させるためのキャッシュや、リアルタイムの更新を可能にするためのサブスクリプション、そして、オフラインのクライアントを簡単に同期できるようにするクライアント側のデータストアなどが、簡単に利用できるようになります。デプロイが完了すると、API リクエストのボリュームに合わせた GraphQL API 実行エンジンの自動的なスケールアップとダウンが、AWS AppSync により行われます。

GraphQL スキーマは、どのようなデータ機能をクライアントアプリケーションに対して実行可能にするかを定義します。例えば、スキーマは、どのクエリが利用可能か、アプリケーションがデータをどのようにサブスクライブできるかについて、基盤となるデータソースについて知ることなく指定します。スキーマはアプリケーションのデータモデルから利用できるタイプシステムによって定義されます。

リゾルバーとは、クライアントから受け取った GraphQL リクエストをデータソース操作用の命令に変換したり、データソースから受け取った応答を GraphQL レスポンスに再度変換したりする機能のことです。

クライアントから受け取った GraphQL リクエストをデータソース操作用の命令に変換するのには「リクエストテンプレート」、データソースからの応答を GraphQL レスポンスに変換するのには「レスポンステンプレート」と呼ばれるマッピングテンプレートが使用されます。

どちらのマッピングテンプレートも Apache Velocity Template Language (VTL) と呼ばれる言語で記述します。

リゾルバーが対応しているデータソースとしては、図にある AWS サービスの他、HTTP データソースにも対応しています。

AWS AppSync では、Mutation (更新) リクエストによりデータの更新が行われた際に、Subscription (購読) しているクライアント (サブスクライバー) に Pure WebSockets を使用してリアルタイムに更新を通知できます。なお、通知を受け取るためには、クライアント (サブスクライバー) は常時 AWS AppSync サービスに接続しておく必要があります。

Amplify DataStore を使用することで、オフラインであってもローカルデバイス上でデータの Query (取得) や Mutation (更新) が行えます。Mutation (更新) が行われた場合、オンラインになった際に AWS AppSync サービスに変更がアップロードされ、競合があった場合は解決されます。