View a markdown version of this page

Jenis sistem (pemetaan respons) - AWS AppSync GraphQL

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Jenis sistem (pemetaan respons)

Saat menerima respons dari DynamoDB, AWS AppSync secara otomatis mengubahnya menjadi tipe primitif GraphQL dan JSON. Setiap atribut di DynamoDB diterjemahkan dan dikembalikan dalam konteks pemetaan respons.

Misalnya, jika DynamoDB mengembalikan yang berikut:

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

Kemudian resolver AWS AppSync DynamoDB mengubahnya menjadi tipe GraphQL dan JSON sebagai:

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

Bagian ini menjelaskan cara AWS AppSync mengonversi jenis skalar, dokumen, dan set DynamoDB berikut:

Jenis string S

Nilai string tunggal. Nilai DynamoDB String dikembalikan sebagai string.

Misalnya, jika DynamoDB mengembalikan nilai String DynamoDB berikut:

{ "S" : "some string" }

AWS AppSync mengubahnya menjadi string:

"some string"
Jenis set string SS

Satu set nilai string. Nilai DynamoDB String Set dikembalikan sebagai daftar string.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB String Set berikut:

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

AWS AppSync mengubahnya menjadi daftar string:

[ "+1 555 123 4567", "+1 555 234 5678" ]
Jenis nomor N

Nilai numerik tunggal. Nilai DynamoDB Number dikembalikan sebagai angka.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB Number berikut:

{ "N" : 1234 }

AWS AppSync mengubahnya menjadi angka:

1234
Jenis set angka NS

Satu set nilai angka. Nilai DynamoDB Number Set dikembalikan sebagai daftar angka.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB Number Set berikut:

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

AWS AppSync mengubahnya menjadi daftar angka:

[ 67.8, 12.2, 70 ]
Jenis biner B

Nilai biner. Nilai DynamoDB Binary dikembalikan sebagai string yang berisi representasi base64 dari nilai itu.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB Binary berikut:

{ "B" : "SGVsbG8sIFdvcmxkIQo=" }

AWS AppSync mengubahnya menjadi string yang berisi representasi base64 dari nilai:

"SGVsbG8sIFdvcmxkIQo="

Perhatikan bahwa data biner dikodekan dalam skema pengkodean base64 seperti yang ditentukan dalam RFC 4648 dan RFC 2045.

Jenis set biner BS

Satu set nilai biner. Nilai DynamoDB Binary Set dikembalikan sebagai daftar string yang berisi representasi base64 dari nilai-nilai.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB Binary Set berikut:

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

AWS AppSync mengubahnya menjadi daftar string yang berisi representasi base64 dari nilai-nilai:

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

Perhatikan bahwa data biner dikodekan dalam skema pengkodean base64 seperti yang ditentukan dalam RFC 4648 dan RFC 2045.

Tipe Boolean BOOL

Nilai Boolean. Nilai DynamoDB Boolean dikembalikan sebagai Boolean.

Misalnya, jika DynamoDB mengembalikan nilai Boolean DynamoDB berikut:

{ "BOOL" : true }

AWS AppSync mengubahnya menjadi Boolean:

true
Jenis daftar L

Daftar nilai DynamoDB lainnya yang didukung. Nilai DynamoDB List dikembalikan sebagai daftar nilai, di mana setiap nilai dalam juga dikonversi.

Misalnya, jika DynamoDB mengembalikan nilai Daftar DynamoDB berikut:

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

AWS AppSync mengubahnya menjadi daftar nilai yang dikonversi:

[ "A string value", 1, [ "Another string value", "Even more string values!" ] ]
Jenis peta M

Kum key/value pulan nilai DynamoDB lainnya yang didukung. Nilai DynamoDB Map dikembalikan sebagai objek JSON, di mana masing-masing juga key/value dikonversi.

Misalnya, jika DynamoDB mengembalikan nilai Peta DynamoDB berikut:

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

AWS AppSync mengubahnya menjadi objek JSON:

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

Nilai nol.

Misalnya, jika DynamoDB mengembalikan nilai DynamoDB Null berikut:

{ "NULL" : null }

AWS AppSync mengubahnya menjadi null:

null