从 DynamoDB 表以 JSON 格式获取数据将 JSON 格式数据插入 DynamoDB 表 DynamoDB 数据类型转换为 JSON 更多信息

Amazon DynamoDB 中的 JSON 支持

注意

本主题中的信息特定于基于.NET Framework 和 3.3 及更早适用于 .NET 的 Amazon SDK 版本的项目。

使用亚马逊 DynamoDB 时适用于 .NET 的 Amazon SDK 支持 JSON 数据。这使您能够更轻松地从 DynamoDB 中获取 JSON 格式的数据以及将 JSON 文档插入到其中。

主题

从 DynamoDB 表以 JSON 格式获取数据
将 JSON 格式数据插入 DynamoDB 表
DynamoDB 数据类型转换为 JSON
更多信息

从 DynamoDB 表以 JSON 格式获取数据

以下示例显示了如何以 JSON 格式从 DynamoDB 表中获取数据：


// 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
//   }

在上述示例中，Document 类的 ToJson 方法将表中的项目转换为 JSON 格式的字符串。项目通过 Table 类的 GetItem 方法检索。为了确定要获取的项目，在本示例中，该GetItem方法使用目标项目 hash-and-range的主键。为确定要从中获取项目的表，Table 类的 LoadTable 方法使用 AmazonDynamoDBClient 类的实例以及 DynamoDB 中的目标表名。

将 JSON 格式数据插入 DynamoDB 表

以下示例演示如何使用 JSON 格式将项目插入到 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);

在上述示例中，FromJson 类的 Document 方法将 JSON 格式的字符串转换为项目。项目通过 PutItem 类的 Table 方法插入表中，该方法使用包含项目的 Document 类的实例。为确定要插入项目的表，调用 Table 类的 LoadTable 方法，并指定 AmazonDynamoDBClient 类的实例以及 DynamoDB 中的目标表名。

DynamoDB 数据类型转换为 JSON

当您调用 Document 类的 ToJson 方法，然后在生成的 JSON 数据上调用 FromJson 方法以将 JSON 数据转换回 Document 类的实例时，一些 DynamoDB 数据类型不会按预期转换。具体来说：

DynamoDB 集（SS、NS 和 BS 类型）将转换为 JSON 数组。
DynamoDB 二进制标量和集（B 和 BS 类型）将转换为 base64 编码的 JSON 字符串或字符串列表。

在此情况下，您必须调用 DecodeBase64Attributes 类的 Document 方法，使用正确的二进制表示形式替换 base64 编码的 JSON 数据。以下示例使用正确的二进制表示形式，在 Document 类的实例中，替换 base64 编码的名为 Picture 的二进制标量项目属性。此示例还在 Document 类的相同实例中，为名为 RelatedPictures 的 base64 编码二进制集项目属性执行相同的操作。
```
item.DecodeBase64Attributes("Picture", "RelatedPictures");
```