AWS AppSyncコンソール機能のツアー

DynamoDB テーブルにデータを追加する前に、AWS AppSync コンソールエクスペリエンスの基本機能を確認する必要があります。ページの左側にある AWS AppSync コンソールタブでは、AWS AppSync が提供する主要なコンポーネントや構成オプションに簡単に移動できます。

スキーマデザイナー

[スキーマ] を選択すると、作成したばかりのスキーマが表示されます。スキーマのコンテンツを確認すると、開発プロセスを効率化するための一連のヘルパー操作が既に読み込まれていることがわかります。スキーマエディターでコードをスクロールすると、前のセクションで定義したモデルにたどり着きます。

type Todo {
	id: ID!
	name: String
	when: String
	where: String
	description: String
}

作成したモデルが、スキーマ全体で使用されていた基本タイプになりました。まず、このタイプから自動的に生成されたミューテーションを使用して、データソースにデータを追加します。

スキーマエディターに関するその他のヒントや情報をいくつか紹介します。

リゾルバーの設定

スキーマデザイナーの [リゾルバー] セクションには、スキーマのすべてのタイプとフィールドが含まれます。フィールドのリストをスクロールすると、[アタッチ] を選択することで特定のフィールドにリゾルバーをアタッチできることがわかります。これによりコードエディターが開き、リゾルバーコードを記述できます。AWSAppSync は VTL ランタイムと JavaScript ランタイムの両方をサポートしています。これらはページ上部で [アクション]、[ランタイムの更新] の順に選択することで変更できます。ページの下部には、複数の操作を順番に実行する関数を作成することもできます。ただし、リゾルバーは上級者向けのトピックなので、このセクションでは説明しません。

データソース

[データソース] を選択して DynamoDB テーブルを表示します。Resource オプション (利用可能な場合) を選択すると、データソースの設定を表示できます。この例では、これは DynamoDB コンソールにつながります。そこから、データを編集できます。データソースを選択し、[編集] を選択することで、一部のデータを直接編集することもできます。データソースを削除する必要が生じた場合は、データソースを選択して [削除] を選択できます。最後に、[データソースの作成] を選択し、名前とタイプを設定することで、新しいデータソースを作成できます。このオプションは、AWS AppSync サービスを既存のリソースにリンクするためのものであることに注意してください。ただし、AWS AppSync がリソースを認識する前に、関連するサービスを使用してアカウントにリソースを作成する必要があります。

クエリ

[クエリ] を選択すると、クエリとミューテーションが表示されます。モデルを使用して GraphQL API を作成したとき、AWS AppSync はテスト目的でいくつかのヘルパーミューテーションとクエリを自動的に生成しました。クエリエディタの左側には Explorer があります。これはすべてのミューテーションとクエリを示すリストです。ここで使いたい操作やフィールドは、名前の値をクリックすることで簡単に有効にできます。これにより、エディタの中央にコードが自動的に表示されます。ここでは、値を変更してミューテーションやクエリを編集できます。エディターの下部には、操作の入力変数のフィールド値を入力できるクエリ変数エディターがあります。エディター上部の [実行] を選択すると、実行するクエリ/ミューテーションを選択するドロップダウンリストが表示されます。この実行の出力は、ページの右側に表示されます。上部の [エクスプローラー] セクションに戻り、操作 (クエリ、ミューテーション、サブスクリプション) を選択し、[+] 記号を選択してその特定の操作の新しいインスタンスを追加できます。ページの上部には、クエリ実行の認可モードを含む別のドロップダウンリストが表示されます。ただし、このセクションではその機能については説明しません (詳細については、「セキュリティ」を参照してください)。

設定

[設定] を選択すると、GraphQL API のいくつかの設定オプションが表示されます。ここでは、ロギング、トレース、ウェブアプリケーションファイアウォール機能などのオプションを有効にできます。また、新しい認可モードを追加して、データが外部に流出するのを防ぐこともできます。ただし、これらのオプションはより高度なものなので、このセクションでは説明しません。