View a markdown version of this page

GetItem - AWS AppSync GraphQL
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 dire 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 singola 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», vedi Type system (request mapping). 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. https://docs.aws.amazon.com/appsync/latest/devguide/js-resolver-reference-dynamodb.html#js-aws-appsync-resolver-reference-dynamodb-projections Questo campo è facoltativo.

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

Per ulteriori informazioni sulla conversione dei tipi DynamoDB, vedere Type system (response mapping).

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 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
  }
}

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