GetItem - AWS AppSync
GetItem champsExemple

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

GetItem

Le document de mappage des demandes vous permet de GetItem demander au résolveur AWS AppSync DynamoDB d'envoyer une GetItem demande à DynamoDB et de spécifier :

  • La clé de l'élément dans DynamoDB

  • S'il convient d'utiliser une lecture cohérente ou non

Le document de mappage GetItem a la structure suivante :

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

Les champs sont définis comme suit :

GetItem champs

version

Version de la définition du modèle. 2017-02-28 et 2018-05-29 sont actuellement prises en charge. Cette valeur est obligatoire.

operation

L'opération DynamoDB à effectuer. Pour que vous puissiez effectuer l'opération DynamoDB GetItem, ce champ doit être défini sur GetItem. Cette valeur est obligatoire.

key

Clé de l'élément dans DynamoDB. Les éléments DynamoDB peuvent avoir une seule clé de hachage ou une clé de hachage et une clé de tri, selon la structure de la table. Pour plus d'informations sur la façon de spécifier une « valeur saisie », voir Système de types (mappage des demandes). Cette valeur est obligatoire.

consistentRead

S'il faut ou non effectuer une lecture très cohérente avec DynamoDB. Ce champ est facultatif et false est la valeur définie par défaut.

projection

Projection utilisée pour spécifier les attributs à renvoyer par l'opération DynamoDB. Pour plus d'informations sur les projections, voir Projections. Ce champ est facultatif.

L'élément renvoyé par DynamoDB est automatiquement converti en GraphQL et en types primitifs, JSON et est disponible dans le contexte de mappage (). $context.result

Pour plus d'informations sur la conversion de type DynamoDB, voir Système de types (mappage des réponses).

Pour plus d'informations sur les modèles de mappage des réponses, consultez la section Vue d'ensemble des modèles de mappage Resolver.

Exemple

L'exemple suivant est un modèle de mappage pour une requête 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
}

Pour plus d'informations sur DynamoDB, consultez la GetItem API documentation DynamoDB. API