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 文件 。