Système de types (mappage des réponses) - AWS AppSync

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.

Système de types (mappage des réponses)

Lorsque vous recevez une réponse de DynamoDB AWS AppSync , elle est automatiquement convertie en GraphQL et en types primitifs. JSON Chaque attribut de DynamoDB est décodé et renvoyé dans le contexte du gestionnaire de réponses.

Par exemple, si DynamoDB renvoie ce qui suit :

{
    "id" : { "S" : "1234" },
    "name" : { "S" : "Nadia" },
    "age" : { "N" : 25 }
}

Lorsque le résultat est renvoyé par votre résolveur de pipeline, il le AWS AppSync convertit en GraphQL JSON et saisissez-le comme suit :

{
    "id" : "1234",
    "name" : "Nadia",
    "age" : 25
}

Cette section explique comment AWS AppSync convertir les types de scalaire, de document et d'ensemble DynamoDB suivants :

Type de chaîne S

Valeur de chaîne unique. Une valeur DynamoDB String est renvoyée sous forme de chaîne.

Par exemple, si DynamoDB a renvoyé la valeur de chaîne DynamoDB suivante :

{ "S" : "some string" }

AWS AppSync le convertit en chaîne :

"some string"
Type d'ensemble de chaîne SS

Ensemble de valeurs de chaîne. Une valeur d'ensemble de chaînes DynamoDB est renvoyée sous forme de liste de chaînes.

Par exemple, si DynamoDB a renvoyé la valeur DynamoDB String Set suivante :

{ "SS" : [ "first value", "second value", ... ] }

AWS AppSync le convertit en une liste de chaînes :

[ "+1 555 123 4567", "+1 555 234 5678" ]
Type de nombre N

Valeur numérique unique. La valeur d'un numéro DynamoDB est renvoyée sous forme de nombre.

Par exemple, si DynamoDB a renvoyé la valeur du numéro DynamoDB suivante :

{ "N" : 1234 }

AWS AppSync le convertit en nombre :

1234
Type d'ensemble de nombres NS

Ensemble de valeurs de nombres. Une valeur d'ensemble de numéros DynamoDB est renvoyée sous forme de liste de nombres.

Par exemple, si DynamoDB a renvoyé la valeur DynamoDB Number Set suivante :

{ "NS" : [ 67.8, 12.2, 70 ] }

AWS AppSync le convertit en une liste de nombres :

[ 67.8, 12.2, 70 ]
Type binaire B

Valeur binaire. Une valeur binaire DynamoDB est renvoyée sous forme de chaîne contenant la représentation base64 de cette valeur.

Par exemple, si DynamoDB a renvoyé la valeur binaire DynamoDB suivante :

{ "B" : "SGVsbG8sIFdvcmxkIQo=" }

AWS AppSync le convertit en une chaîne contenant la représentation base64 de la valeur :

"SGVsbG8sIFdvcmxkIQo="

Notez que les données binaires sont codées dans le schéma de codage base64 tel que spécifié dans RFC4648 et RFC 2045.

Type d'ensemble binaire BS

Ensemble de valeurs binaires. Une valeur d'ensemble binaire DynamoDB est renvoyée sous la forme d'une liste de chaînes contenant la représentation base64 des valeurs.

Par exemple, si DynamoDB a renvoyé la valeur d'ensemble binaire DynamoDB suivante :

{ "BS" : [ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ] }

AWS AppSync le convertit en une liste de chaînes contenant la représentation en base64 des valeurs :

[ "SGVsbG8sIFdvcmxkIQo=", "SG93IGFyZSB5b3U/Cg==" ... ]

Notez que les données binaires sont codées dans le schéma de codage base64 tel que spécifié dans RFC4648 et RFC 2045.

Type booléen BOOL

Valeur booléenne. Une valeur booléenne DynamoDB est renvoyée sous forme de booléen.

Par exemple, si DynamoDB a renvoyé la valeur booléenne DynamoDB suivante :

{ "BOOL" : true }

AWS AppSync le convertit en booléen :

true
Type de liste L

Liste de toutes les autres valeurs DynamoDB prises en charge. Une valeur de liste DynamoDB est renvoyée sous forme de liste de valeurs, chaque valeur interne étant également convertie.

Par exemple, si DynamoDB a renvoyé la valeur de liste DynamoDB suivante :

{ "L" : [
      { "S"  : "A string value" },
      { "N"  : 1 },
      { "SS" : [ "Another string value", "Even more string values!" ] }
   ]
}

AWS AppSync le convertit en une liste de valeurs converties :

[ "A string value", 1, [ "Another string value", "Even more string values!" ] ]
Type de mappage M

A key/value collection of any other supported DynamoDB value. A DynamoDB Map value is returned as a JSON object, where each key/value est également converti.

Par exemple, si DynamoDB a renvoyé la valeur de carte DynamoDB suivante :

{ "M" : {
      "someString" : { "S"  : "A string value" },
      "someNumber" : { "N"  : 1 },
      "stringSet"  : { "SS" : [ "Another string value", "Even more string values!" ] }
   }
}

AWS AppSync le convertit en JSON objet :

{
   "someString" : "A string value",
   "someNumber" : 1,
   "stringSet"  : [ "Another string value", "Even more string values!" ]
}
Type nul NULL

Valeur null.

Par exemple, si DynamoDB a renvoyé la valeur Null DynamoDB suivante :

{ "NULL" : null }

AWS AppSync le convertit en valeur nulle :

null