GetItem - AWS AppSync
GetItem FelderBeispiel

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetItem

Mit der GetItem Anfrage können Sie die AWS AppSync DynamoDB-Funktion anweisen, eine GetItem Anfrage an DynamoDB zu stellen, und Sie können Folgendes angeben:

  • Der Schlüssel des Elements in DynamoDB

  • Ob ein Consistent-Lesevorgang verwendet wird oder nicht

Die GetItem Anfrage hat die folgende Struktur:

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

Die Felder sind wie folgt definiert:

GetItem Felder

operation

Der DynamoDB DynamoDB-Vorgang. Um die GetItem-DynamoDB-Operation durchzuführen, muss diese auf GetItem gesetzt sein. Dieser Wert ist erforderlich.

key

Der Schlüssel des Elements in DynamoDB. DynamoDB-Elemente können je nach Tabellenstruktur einen einzelnen Hashschlüssel oder einen Hashschlüssel und einen Sortierschlüssel haben. Weitere Informationen zur Angabe eines „typisierten Werts“ finden Sie unter Typsystem (Anforderungszuordnung). Dieser Wert ist erforderlich.

consistentRead

Ob ein stark konsistenter Lesevorgang mit DynamoDB durchgeführt werden soll oder nicht. Dieser Schritt ist optional und standardmäßig auf false gesetzt.

projection

Eine Projektion, die verwendet wird, um die Attribute anzugeben, die von der DynamoDB-Operation zurückgegeben werden sollen. Weitere Informationen zu Projektionen finden Sie unter Projektionen. Dies ist ein optionales Feld.

Das von DynamoDB zurückgegebene Element wird automatisch in GraphQL und JSON primitive Typen konvertiert und ist im Kontext result () verfügbar. context.result

Weitere Informationen zur DynamoDB-Typkonvertierung finden Sie unter Typsystem (Antwortzuordnung).

Weitere Informationen zu JavaScript Resolvern finden Sie unter JavaScript Übersicht über Resolver.

Beispiel

Das folgende Beispiel ist ein Funktionsanforderungshandler für eine GraphQL-AbfragegetThing(foo: String!, bar: String!):

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

Weitere Informationen zu DynamoDB finden Sie in der GetItem API APIDynamoDB-Dokumentation.