AWS AppSync DynamoDB のリゾルバーマッピングテンプレートリファレンス - AWS AppSync

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS AppSync DynamoDB のリゾルバーマッピングテンプレートリファレンス

注記

現在、主に APPSYNC_JS ランタイムとそのドキュメントをサポートしています。APPSYNC_JS ランタイムとそのガイドの使用を検討してくださいhttps://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html。

AWS AppSync DynamoDB 関数を使用すると、受信した GraphQL GraphQL リクエストを DynamoDB コールにマッピングし、DynamoDB レスポンスを GraphQL にマッピングして、GraphQL を使用してアカウント内の既存の Amazon DynamoDB テーブルにデータを保存および取得できます。このセクションでは、サポートされている DynamoDB オペレーションのリクエストハンドラーとレスポンスハンドラーについて説明します。

  • GetItem - GetItem リクエストでは、DynamoDB 関数に DynamoDB への GetItem リクエストを行うように指示し、DynamoDB の項目のキーと、一貫した読み取りを使用するかどうかを指定できます。

  • PutItem - PutItem リクエストマッピングドキュメントでは、DynamoDB 関数に DynamoDB への PutItem リクエストを行うように指示し、DynamoDB の項目のキー、項目の全内容 (キーと で構成されるattributeValues）、およびオペレーションが成功するための条件を指定できます。

  • UpdateItem - UpdateItem リクエストにより、DynamoDB 関数に DynamoDB への UpdateItem リクエストを行うように指示し、DynamoDB の項目のキー、DynamoDB の項目を更新する方法を説明する更新式、およびオペレーションが成功するための条件を指定できます。 DynamoDB

  • DeleteItem - DeleteItem リクエストでは、DynamoDB 関数に DynamoDB への DeleteItem リクエストを行うように指示し、DynamoDB の項目のキーと、オペレーションが成功するための条件を指定できます。

  • クエリ - クエリリクエストオブジェクトを使用すると、DynamoDB リゾルバーに DynamoDB へのクエリリクエストを行うように指示し、キー式、使用するインデックス、追加のフィルター、返される項目の数、一貫した読み取りを使用するかどうか、クエリの方向 (転送または逆方向）、ページ分割トークンを指定できます。

  • スキャン - スキャンリクエストでは、DynamoDB 関数に DynamoDB へのスキャンリクエストを行うように指示し、結果、使用するインデックス、返す項目の数、整合性のある読み取り、ページ分割トークン、並列スキャンを使用するかどうかを除外するフィルターを指定できます。

  • 同期 - 同期リクエストオブジェクトを使用すると、DynamoDB テーブルからすべての結果を取得し、最後のクエリ (デルタ更新) 以降に変更されたデータのみを受信できます。同期リクエストは、バージョニングされた DynamoDB データソースに対してのみ行うことができます。フィルタを指定して、結果、返す項目の数、ページ分割トークン、および最後の Sync オペレーションが開始された日時を除外できます。

  • BatchGetItem - BatchGetItem リクエストオブジェクトを使用すると、DynamoDB 関数に DynamoDB に BatchGetItem リクエストして、複数のテーブルにまたがる可能性のある複数の項目を取得するよう指示できます。このリクエストオブジェクトでは、 から項目を取得するテーブル名と、各テーブルから取得する項目のキーを指定する必要があります。

  • BatchDeleteItem - BatchDeleteItem リクエストオブジェクトを使用すると、DynamoDB 関数に DynamoDB に複数の項目を削除する BatchWriteItem リクエストを行うように指示できます。場合によっては複数のテーブルにまたがります。このリクエストオブジェクトでは、 から項目を削除するテーブル名と、各テーブルから削除する項目のキーを指定する必要があります。

  • BatchPutItem - BatchPutItem リクエストオブジェクトを使用すると、DynamoDB 関数に DynamoDB に複数の項目を、場合によっては複数のテーブルにまたがって配置するように BatchWriteItem リクエストするように指示できます。このリクエストオブジェクトでは、項目を配置するテーブル名と、各テーブルに配置する完全な項目を指定する必要があります。

  • TransactGetItems - TransactGetItems リクエストオブジェクトを使用すると、DynamoDB 関数に DynamoDB に TransactGetItems リクエストを行い、複数のテーブルにまたがる可能性のある複数の項目を取得するように指示できます。このリクエストオブジェクトでは、 から項目を取得する各リクエスト項目のテーブル名と、各テーブルから取得する各リクエスト項目のキーを指定する必要があります。

  • TransactWriteItems - TransactWriteItems リクエストオブジェクトを使用すると、DynamoDB 関数に DynamoDB に複数の項目を書き込む TransactWriteItems リクエストを行うように指示できます。場合によっては複数のテーブルに書き込むことができます。このリクエストオブジェクトでは、各リクエスト項目の宛先テーブル名、実行する各リクエスト項目のオペレーション、および書き込む各リクエスト項目のキーを指定する必要があります。

  • タイプシステム (リクエストマッピング) - DynamoDB タイピングが AWS AppSync リクエストにどのように統合されるかについて説明します。

  • タイプシステム (レスポンスマッピング) - DynamoDB タイプが GraphQL またはレスポンスペイロードJSONで自動的に変換される方法について説明します。

  • フィルター - クエリおよびスキャンオペレーションのフィルターの詳細について説明します。

  • 条件式 - PutItem、 UpdateItem、および DeleteItem オペレーションの条件式の詳細について説明します。

  • トランザクション条件式 - TransactWriteItems オペレーションの条件式の詳細について説明します。

  • プロジェクション - 読み取りオペレーションで属性を指定する方法について詳しく説明します。