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 的更多信息，请参阅 GetItem API DynamoDB 文档。API