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 de mappage des réponses.

Par exemple, si DynamoDB renvoie ce qui suit :

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

Le résolveur AWS AppSync DynamoDB le convertit ensuite en GraphQL et le saisit comme suit : JSON

{
    "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 de caractères :

"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 :

[ "[phone]", "[phone]" ]

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

Collection clé/valeur de toute autre valeur DynamoDB prise en charge. Une valeur de carte DynamoDB est renvoyée sous forme d'objet, chaque clé/valeur étant JSON également convertie.

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