翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
はじめに: GraphQL API の作成を開始する
AWS AppSyncコンソールを使用して、GraphQL API を設定して起動することができます。GraphQL API には通常、次の 3 つのコンポーネントが必要です。
-
GraphQL スキーマ - GraphQL スキーマは API の設計図です。操作の実行時にリクエストできるタイプとフィールドを定義します。スキーマにデータを入力するには、データソースを GraphQL API に接続する必要があります。このクイックスタートガイドでは、定義済みのモデルを使用してスキーマを作成します。
-
データソース - GraphQL API にデータを入力するためのデータを含むリソースです。DynamoDB テーブル、Lambda 関数などを指定できます。AWSAppSyncは、堅牢でスケーラブルなGraphQL APIを構築するための多数のデータソースをサポートしています。データソースはスキーマのフィールドにリンクされています。フィールドに対してリクエストが実行されるたびに、ソースからのデータがフィールドに入力されます。このメカニズムはリゾルバーによって制御されます。このクイックスタートガイドでは、スキーマと一緒に定義済みのモデルを使用してデータソースを作成します。
-
リゾルバー - リゾルバーはスキーマフィールドをデータソースにリンクする役割を担います。ソースからデータを取得し、フィールドで定義した内容に基づいて結果を返します。 AWSAppSyncは、GraphQL APIのリゾルバーを記述するためのJavaScriptとVTLの両方をサポートしています。このクイックスタートガイドでは、リゾルバーはスキーマとデータソースに基づいて自動的に生成されます。このセクションではこれについては詳しく説明しません。
AWS AppSync は、すべてのGraphQLコンポーネントの作成と構成をサポートしています。コンソールを開くと、以下の方法を使用して API を作成できます。
-
事前定義されたモデルを使用してカスタマイズされた GraphQL API を生成し、それをサポートする新しい DynamoDB テーブル (データソース) を設定して設計します。
-
空白のスキーマを使用し、データソースやリゾルバーなしでGraphQL APIを設計します。
-
DynamoDB テーブルを使用してデータをインポートし、スキーマのタイプとフィールドを生成します。
-
AWS AppSync の WebSocket 機能と Pub/Sub アーキテクチャを使用してリアルタイム API を開発します。
-
既存の GraphQL API (ソース API) を使用してマージされた API にリンクします。
注記
より高度なツールを使用する前に、「スキーマの設計」セクションを確認することをおすすめします。これらのガイドでは、AWS AppSyncでより複雑なアプリケーションを構築するために概念的に使用できる簡単な例について説明します。
AWS AppSyncは、GraphQL APIを作成するためのコンソール以外のオプションもいくつかサポートしています。具体的には次のとおりです。
-
AWS Amplify
AWS SAM
-
AWS CloudFormation
-
CDK
次の例は、事前定義されたモデルと DynamoDB を使用して GraphQL API の基本的なコンポーネントを作成する方法を示しています。