GetItem - AWS AppSync
GetItem campiEsempio

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

GetItem

La GetItem richiesta consente di indicare alla funzione AWS AppSync DynamoDB di effettuare una GetItem richiesta a DynamoDB e consente di specificare:

  • La chiave dell'elemento in DynamoDB

  • Se utilizzare una lettura consistente o no

La GetItem richiesta ha la seguente struttura:

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

I campi sono definiti come segue:

GetItem campi

operation

L'operazione DynamoDB da eseguire. Per eseguire l'operazione GetItem DynamoDB, il valore deve essere impostato su GetItem. Questo valore è obbligatorio.

key

La chiave dell'elemento in DynamoDB. Gli elementi DynamoDB possono avere una sola chiave hash o una chiave hash e una chiave di ordinamento, a seconda della struttura della tabella. Per ulteriori informazioni su come specificare un «valore digitato», consulta Sistema di tipi (mappatura delle richieste). Questo valore è obbligatorio.

consistentRead

Se eseguire o meno una lettura fortemente coerente con DynamoDB. Si tratta di un'opzione facoltativa, impostata di default su false.

projection

Una proiezione utilizzata per specificare gli attributi da restituire dall'operazione DynamoDB. Per ulteriori informazioni sulle proiezioni, vedere Proiezioni. Questo campo è facoltativo.

L'elemento restituito da DynamoDB viene automaticamente convertito in GraphQL e tipi primitivi JSON ed è disponibile nel contesto result (). context.result

Per ulteriori informazioni sulla conversione dei tipi in DynamoDB, vedere Sistema dei tipi (mappatura delle risposte).

Per ulteriori informazioni sui JavaScript resolver, consulta la panoramica dei resolver. JavaScript

Esempio

L'esempio seguente è un gestore di richieste di funzioni per una query getThing(foo: String!, bar: String!) GraphQL:

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

Per ulteriori informazioni su DynamoDB, consulta la documentazione di GetItem API DynamoDB. API