View a markdown version of this page

GetItem - AWS AppSync GraphQL

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

Il documento di mappatura delle GetItem richieste consente di dire al resolver 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

Il documento di mappatura GetItem ha la seguente struttura:

{ "version" : "2017-02-28", "operation" : "GetItem", "key" : { "foo" : ... typed value, "bar" : ... typed value }, "consistentRead" : true, "projection" : { ... } }

I campi sono definiti come segue:

GetItem campi

version

La versione di definizione del modello. Al momento sono supportate le versioni 2017-02-28 e 2018-05-29. Questo valore è obbligatorio.

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/resolver-mapping-template-reference-dynamodb.html#aws-appsync-resolver-mapping-template-reference-dynamodb-projections Questo campo è facoltativo.

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

Per ulteriori informazioni sulla conversione dei tipi DynamoDB, vedere Type system (response mapping). Sistema di tipi (mappatura delle risposte)

Per ulteriori informazioni sui modelli di mappatura delle risposte, vedi Panoramica dei modelli di mappatura di Resolver.

Esempio

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

{ "version" : "2017-02-28", "operation" : "GetItem", "key" : { "foo" : $util.dynamodb.toDynamoDBJson($ctx.args.foo), "bar" : $util.dynamodb.toDynamoDBJson($ctx.args.bar) }, "consistentRead" : true }

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