GraphQL APIを簡単に作成 & 運用。AWS AppSync をグラレコで解説
Author : 安田 茂樹
※ 本連載では、様々な AWS サービスをグラフィックレコーディングで紹介する awsgeek.com を、日本語に翻訳し、図の解説をしていきます。awsgeek.com は Amazon Web Services, Inc. プリンシパル・テクニカル・エバンジェリスト、ジェリー・ハーグローブが運営しているサイトです。
GraphQL とは ?
GraphQL は、サーバーからのデータに対して、クライアントによるフェッチ、変更、サブスクライブを可能にするデータ言語です。GraphQL クエリでは、サーバーから返されたデータをどのように構造化するかをクライアントが指定します。これによって、クライアントは必要なデータのみを必要なフォーマットでクエリできます。
Web API として有名な RESTful (REST) と比較した場合、主に以下の違いがあります。
|
RESTful (REST) |
GraphQL |
エンドポイント |
操作ごとにエンドポイント (URL) が異なる (例) |
単一エンドポイント (URL) で全ての操作を行える |
データの取得 |
全データを取得することになるため、取得したデータのフィルタリング処理が必要 (例) |
必要なデータのみ取得可能なため、取得したデータのフィルタリング処理が不要 (例) |
対応するAWSサービス |
Amazon API Gateway |
AWS AppSync |
AWS AppSync について
アプリケーション開発が加速できるという理由から、各組織では API の構築に GraphQL を選択しています。この API により、フロントエンドのデベロッパーは、複数のデータベースやマイクロサービス、そして API に対し、単一の GraphQL エンドポイントから迅速にクエリができるようになります。
AWS AppSync は、GraphQL API の開発を容易にする、フルマネージド型サービスです。このサービスは、AWS DynamoDB や Lambda、その他のデータソースとの安全な接続に必要な、面倒な作業を自動的に処理します。パフォーマンスを向上させるためのキャッシュや、リアルタイムの更新を可能にするためのサブスクリプション、そして、オフラインのクライアントを簡単に同期できるようにするクライアント側のデータストアなどが、簡単に利用できるようになります。デプロイが完了すると、API リクエストのボリュームに合わせた GraphQL API 実行エンジンの自動的なスケールアップとダウンが、AWS AppSync により行われます。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_01.1b36483ce61c0342fad5f280f218a3c3a5783c17.png)
スキーマとは ?
GraphQL スキーマは、どのようなデータ機能をクライアントアプリケーションに対して実行可能にするかを定義します。例えば、スキーマは、どのクエリが利用可能か、アプリケーションがデータをどのようにサブスクライブできるかについて、基盤となるデータソースについて知ることなく指定します。スキーマはアプリケーションのデータモデルから利用できるタイプシステムによって定義されます。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_02.11746a48b96a763a76ff8d792cd40a85b9fb3579.png)
リゾルバーとは ?
リゾルバーとは、クライアントから受け取った GraphQL リクエストをデータソース操作用の命令に変換したり、データソースから受け取った応答を GraphQL レスポンスに再度変換したりする機能のことです。
クライアントから受け取った GraphQL リクエストをデータソース操作用の命令に変換するのには「リクエストテンプレート」、データソースからの応答を GraphQL レスポンスに変換するのには「レスポンステンプレート」と呼ばれるマッピングテンプレートが使用されます。
どちらのマッピングテンプレートも Apache Velocity Template Language (VTL) と呼ばれる言語で記述します。
リゾルバーが対応しているデータソースとしては、図にある AWS サービスの他、HTTP データソースにも対応しています。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_03.7b1998c63c55bb078d8d24e84dfc5184d1b5850b.png)
リアルタイムにデータ更新を通知可能
AWS AppSync では、Mutation (更新) リクエストによりデータの更新が行われた際に、Subscription (購読) しているクライアント (サブスクライバー) に Pure WebSockets を使用してリアルタイムに更新を通知できます。なお、通知を受け取るためには、クライアント (サブスクライバー) は常時 AWS AppSync サービスに接続しておく必要があります。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_04.c69bbf4984d0527247bf37a936874740807d3715.png)
オフラインでのデータアクセスに対応
Amplify DataStore を使用することで、オフラインであってもローカルデバイス上でデータの Query (取得) や Mutation (更新) が行えます。Mutation (更新) が行われた場合、オンラインになった際に AWS AppSync サービスに変更がアップロードされ、競合があった場合は解決されます。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_05.67812c2c477d4f76abcf9dd6acc4ce27a3caee7c.png)
まとめ
最後に、全体の図を見てみましょう。
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/2021/img_awsgeek-appsync_full.fafb8c15e88c47fcae50fb8d57640b69b2a437ec.png)
本記事では、GraphQL API を簡単に作成・運用できる AWS のフルマネージド型サービスである AWS AppSync についてご紹介しました。
AWS AppSync の料金等、サービスの詳細に関しましては、こちら をご覧ください。
AWS グラレコ解説のその他の記事はこちら
- 選択
- 今話題のブロックチェーンをAWSで実現する仕組みをグラレコで解説 »
- サーバーレスって何が便利なの ? AWS でサーバーレスを構築するためのサービスをグラレコで解説 »
- 機械学習のワークフローってどうなっているの ? AWS の機械学習サービスをグラレコで解説 »
- 外部から AWS のバックエンドサービス利用を実現する仕組みをグラレコで解説 »
- AWS でデプロイの自動化を実現するベストプラクティスをグラレコで解説 »
- コンテナを使ってモノリスを分割する方法をグラレコで解説 »
- クラウドへ移行する理由とそのステップをグラレコで解説 »
- Windows ワークロードをクラウドへ移行するためのベストプラクティスをグラレコで解説 »
- サーバーレスのイベントバスって何 ? Amazon EventBridge をグラレコで解説 »
- サーバーレスで SaaS を構築する方法をグラレコで解説 »
- 「あなたへのおすすめ」はどう生成するの ? Amazon Personalize で簡単に実現する方法をグラレコで解説 »
- クラウド設計・運用のベストプラクティス集「AWS Well-Architectedフレームワーク」をグラレコで解説 »
- 特定の顧客セグメントにメッセージ送信。「Amazon Pinpoint」の仕組みをグラレコで解説 »
- アプリにユーザー認証機能を簡単に追加できる「Amazon Cognito」をグラレコで解説 »
- わずか数分で WordPress サイトを構築できる「Amazon Lightsail」をグラレコで解説 »
- 異なるアプリケーション同士の疎結合を実現。「Amazon SQS」をグラレコで解説 »
- Web アプリを高速に開発できる「AWS Amplify」をグラレコで解説 »
- 機械学習の知識ゼロでもテキストデータを分析。Amazon Comprehend をグラレコで解説 »
- ビジネスデータをまとめて可視化 & 分析。Amazon QuickSight をグラレコで解説
- 人工衛星の地上局を 1 分単位で利用。AWS Ground Station をグラレコで解説
- カオスエンジニアリングで本当にカオスにならないための進め方をグラレコで解説
- GraphQL API を簡単に作成 & 運用。AWS AppSync をグラレコで解説
- IoT 環境を必要な機能を選択するだけで構築。AWS IoT をグラレコで解説
- 高い可用性と耐久性のオブジェクトストレージ。Amazon S3 をグラレコで解説
- サーバーレスでイベント駆動型アプリケーションを実現。AWS Lambda をグラレコで解説
- データサイエンス教育の強い味方。Amazon SageMaker Studio Lab をグラレコで解説
- 高速で柔軟な NoSQL データベースサービス。Amazon DynamoDB をグラレコで解説
- リレーショナルデータベースを簡単・迅速に実現。Amazon RDS をグラレコで解説
- アプリのワークフローを視覚的に構成。 AWS Step Functions をグラレコで解説
- データ保護に使う暗号化キーを一元管理。AWS KMS をグラレコで解説
- アプリケーションへのトラフィックを効率的に負荷分散。Application Load Balancer をグラレコで解説
- AWS で簡単にコンテナアプリケーションを構築 ! Amazon ECS をグラレコで解説
- 大規模データセットも簡単クエリ! Amazon Athena をグラレコで解説
- キャッシュ機能でアプリの高速化を実現 ! Amazon ElastiCache をグラレコで解説
- 使い慣れたプログラミング言語でクラウド環境を構築 ! AWS CDK をグラレコで解説
- ストリーミングデータを簡単にキャプチャ、処理、保存 ! Amazon Kinesis Data Streams をグラレコで解説
- AWS で始める機械学習はじめの一歩 ! AWS の主要な AI/ML サービスをグラレコで解説
- リレーショナルデータベースをサーバーレス化 ! Amazon Aurora Serverless をグラレコで解説
- ML 駆動の検索エンジンで企業の情報管理を革新! Amazon Kendra をグラレコで解説
- オンプレミス、エッジ、どこでも楽々コンテナ管理 ! Amazon EKS Anywhere をグラレコで解説
- 生成 AI アプリケーション開発をもっと身近に、簡単に ! Amazon Bedrock をグラレコで解説
- わずか数クリックで多様な脅威を監視しクラウドを保護 ! 脅威検出サービス Amazon GuardDuty をグラレコで解説
- データの改ざん耐性と変更履歴の検証可能性を実現 ! 台帳データベース Amazon QLDB をグラレコで解説
- 生成 AI x クラウドがもたらす次世代のイノベーション ! AWS Summit Japan Day 1 基調講演をグラレコで解説
筆者プロフィール
![](https://d1.awsstatic.com/Developer%20Marketing/jp/magazine/profile/photo_yasuda.15e006a2fdab9ee62165f980ea5a01c08c966cb8.jpg)
安田 茂樹
アマゾンウェブサービスジャパン合同会社
技術統括本部 プログラムマネージャー
2014 年にアマゾンジャパン合同会社に入社後、デバイス試験部門にて発売前の数多くの Amazon デバイスの試験に携わる。2019 年にアマゾンウェブサービスジャパン合同会社に入社後、テクニカルコンテンツマネージャーを経て、2021 年より現職。趣味は新しいガジェットを試すこと、旅行、食べ歩き。
AWS を無料でお試しいただけます