AWS SDK untuk .NET V3 telah memasuki mode pemeliharaan.

Kami menyarankan Anda bermigrasi ke [AWS SDK untuk .NET V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman mode pemeliharaan](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/) kami.

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

# Dukungan JSON di Amazon DynamoDB
<a name="dynamodb-json"></a>

**catatan**  
Informasi dalam topik ini khusus untuk proyek berdasarkan .NET Framework dan AWS SDK untuk .NET versi 3.3 dan sebelumnya.

 AWS SDK untuk .NET Mendukung data JSON saat bekerja dengan Amazon DynamoDB. Ini memungkinkan Anda untuk lebih mudah mendapatkan data berformat JSON dari, dan memasukkan dokumen JSON ke dalam, tabel DynamoDB.

**Topics**
+ [Dapatkan Data dari Tabel DynamoDB dalam Format JSON](#dynamodb-json-get-table-data)
+ [Masukkan Data Format JSON ke dalam Tabel DynamoDB](#dynamodb-json-insert-table-data)
+ [DynamoDB Konversi Tipe Data ke JSON](#dynamodb-json-datatypes)
+ [Info Selengkapnya](#dynamodb-json-more-info)

## Dapatkan Data dari Tabel DynamoDB dalam Format JSON
<a name="dynamodb-json-get-table-data"></a>

Contoh berikut menunjukkan bagaimana untuk mendapatkan data dari tabel DynamoDB dalam format JSON:

```
// using Amazon.DynamoDBv2;
// using Amazon.DynamoDBv2.DocumentModel;

var client = new AmazonDynamoDBClient();
var table = Table.LoadTable(client, "AnimalsInventory");
var item = table.GetItem(3, "Horse");

var jsonText = item.ToJson();
Console.Write(jsonText);
      
// Output:
//   {"Name":"Shadow","Type":"Horse","Id":3}

var jsonPrettyText = item.ToJsonPretty();
Console.WriteLine(jsonPrettyText);
      
// Output:
//   {
//     "Name" : "Shadow",
//     "Type" : "Horse",
//     "Id"   : 3
//   }
```

Dalam contoh sebelumnya, `ToJson` metode `Document` kelas mengubah item dari tabel menjadi string berformat JSON. Item diambil melalui `GetItem` metode `Table` kelas. Untuk menentukan item yang akan didapatkan, dalam contoh ini, `GetItem` metode menggunakan kunci hash-and-range utama dari item target. Untuk menentukan tabel untuk mendapatkan item dari, `LoadTable` metode `Table` kelas menggunakan instance dari `AmazonDynamoDBClient` kelas dan nama tabel target di DynamoDB.

## Masukkan Data Format JSON ke dalam Tabel DynamoDB
<a name="dynamodb-json-insert-table-data"></a>

Contoh berikut menunjukkan bagaimana menggunakan format JSON untuk menyisipkan item ke dalam tabel DynamoDB:

```
// using Amazon.DynamoDBv2;
// using Amazon.DynamoDBv2.DocumentModel;

var client = new AmazonDynamoDBClient();
var table = Table.LoadTable(client, "AnimalsInventory");
var jsonText = "{\"Id\":6,\"Type\":\"Bird\",\"Name\":\"Tweety\"}";
var item = Document.FromJson(jsonText);

table.PutItem(item);
```

Dalam contoh sebelumnya, `FromJson` metode `Document` kelas mengkonversi string JSON-diformat menjadi item. Item dimasukkan ke dalam tabel melalui `PutItem` metode `Table` kelas, yang menggunakan instance `Document` kelas yang berisi item. Untuk menentukan tabel untuk memasukkan item ke dalam, `LoadTable` metode `Table` kelas dipanggil, menentukan instance `AmazonDynamoDBClient` kelas dan nama tabel target di DynamoDB.

## DynamoDB Konversi Tipe Data ke JSON
<a name="dynamodb-json-datatypes"></a>

Setiap kali Anda memanggil `ToJson` metode `Document` kelas, dan kemudian pada data JSON yang dihasilkan Anda memanggil `FromJson` metode untuk mengubah data JSON kembali ke instance `Document` kelas, beberapa tipe data DynamoDB tidak akan dikonversi seperti yang diharapkan. Secara khusus:
+ DynamoDB set (`SS``NS`,, `BS` dan jenis) akan dikonversi ke array JSON.
+ Skalar dan set biner DynamoDB (`B``BS`dan tipe) akan dikonversi ke string JSON yang dikodekan base64 atau daftar string.

  Dalam skenario ini, Anda harus memanggil `DecodeBase64Attributes` metode `Document` kelas untuk mengganti data JSON yang dikodekan base64 dengan representasi biner yang benar. Contoh berikut menggantikan atribut item skalar biner berkode base64 dalam contoh `Document` kelas, bernama`Picture`, dengan representasi biner yang benar. Contoh ini juga melakukan hal yang sama untuk atribut item set biner yang dikodekan base64 dalam contoh kelas yang sama, bernama: `Document` `RelatedPictures`

  ```
  item.DecodeBase64Attributes("Picture", "RelatedPictures");
  ```

## Info Selengkapnya
<a name="dynamodb-json-more-info"></a>

Untuk informasi lebih lanjut dan contoh pemrograman JSON dengan DynamoDB dengan, lihat: AWS SDK untuk .NET
+  [Dukungan DynamoDB JSON](https://aws.amazon.com/blogs/developer/dynamodb-json-support/) 
+  [Pembaruan Amazon DynamoDB - JSON, Tingkat Gratis yang Diperluas, Penskalaan Fleksibel, Item Lebih Besar](https://aws.amazon.com/blogs/aws/dynamodb-update-json-and-more/)