GetItem - AWS AppSync
GetItem フィールド例

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

GetItem

GetItem リクエストでは、 AWS AppSync DynamoDB 関数に DynamoDB にGetItemリクエストを行うように指示し、以下を指定できます。

  • DynamoDB の項目のキー

  • 整合性のある読み込みを使用するかどうか

GetItem リクエストの構造は次のとおりです。

type DynamoDBGetItem = {
  operation: 'GetItem';
  key: { [key: string]: any };
  consistentRead?: ConsistentRead;
  projection?: {
    expression: string;
    expressionNames?: { [key: string]: string };
  };
};

各フィールドの定義は以下のようになります。

GetItem フィールド

operation

実行する DynamoDB の処理。GetItem DynamoDB の処理を実行するには、これを GetItem に設定する必要があります。この値は必須です。

key

DynamoDB の項目のキー。DynamoDB の項目には、単一のハッシュキー、またはハッシュキーとソートキーが含まれています。これはテーブルの構造によって変わります。「型付き値」を指定する方法の詳細については、「型システム (リクエストマッピング)」を参照してください。この値は必須です。

consistentRead

DynamoDB で強力な整合性のある読み込みを実行するかどうかを示します。これはオプションであり、デフォルトは false です。

projection

DynamoDB オペレーションから返される属性を指定するために使用されるプロジェクション。プロジェクションの詳細については、「プロジェクション」を参照してください。このフィールドはオプションです。

DynamoDB から返される項目は、GraphQL とJSONプリミティブタイプに自動的に変換され、コンテキスト結果 () で使用できますcontext.result。

DynamoDB の型変換の詳細については、「型システム (リクエストマッピング)」を参照してください。

JavaScript リゾルバーの詳細については、JavaScript 「リゾルバーの概要」を参照してください。

例

次の例は、GraphQL getThing(foo: String!, bar: String!) クエリの関数リクエストハンドラーです。

export function request(ctx) {
  const {foo, bar} = ctx.args
  return {
    operation : "GetItem",
    key : util.dynamodb.toMapValues({foo, bar}),
    consistentRead : true
  }
}

DynamoDB の詳細についてはGetItemAPI、DynamoDB APIドキュメント を参照してください。