适用于 DynamoDB 的 Amazon S3 导入格式 - Amazon DynamoDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

适用于 DynamoDB 的 Amazon S3 导入格式

DynamoDB 可以三种格式导入数据:CSV、DynamoDB JSON 和 Amazon Ion。

CSV

CSV 格式的文件由换行符分隔的多个项目组成。默认情况下,DynamoDB 会将导入文件的第一行解释为标头,并期望列以逗号分隔。您也可以定义要应用的标头,只要它们与文件中的列数匹配即可。如果显式定义标头,则文件的第一行将作为值导入。

注意

从 CSV 文件导入时,除基表和二级索引的哈希范围和键之外的所有列都将作为 DynamoDB 字符串导入。

转义双引号

CSV 文件中存在的任何双引号字符都必须进行转义。如果未对它们进行转义(例如在以下示例中),则导入将失败:

id,value "123",Women's Full Lenth Dress

如果使用两组双引号转义引号,则相同的导入将成功:

id,value """123""",Women's Full Lenth Dress

文本在经过适当转义和导入后,它将与原始 CSV 文件中的显示效果相同:

id,value "123",Women's Full Lenth Dress

DynamoDB JSON

DynamoDB JSON 格式的文件可能包含多个 Item 对象。每个单独对象采用 DynamoDB 的标准编组 JSON 格式,换行符用作项目分隔符。作为一项附加功能,原定设置情况下,支持将时间点导出作为导入源。

注意

新行用作 DynamoDB JSON 格式文件的项目分隔符,不应在项目对象中使用。

{ "Item": { "Authors": { "SS": ["Author1", "Author2"] }, "Dimensions": { "S": "8.5 x 11.0 x 1.5" }, "ISBN": { "S": "333-3333333333" }, "Id": { "N": "103" }, "InPublication": { "BOOL": false }, "PageCount": { "N": "600" }, "Price": { "N": "2000" }, "ProductCategory": { "S": "Book" }, "Title": { "S": "Book 103 Title" } } }
注意

新行用作 DynamoDB JSON 格式文件的项目分隔符,不应在项目对象中使用。

{ "Item": { "Authors": { "SS": ["Author1", "Author2"] }, "Dimensions": { "S": "8.5 x 11.0 x 1.5" }, "ISBN": { "S": "333-3333333333" }, "Id": { "N": "103" }, "InPublication": { "BOOL": false }, "PageCount": { "N": "600" }, "Price": { "N": "2000" }, "ProductCategory": { "S": "Book" }, "Title": { "S": "Book 103 Title" } } } { "Item": { "Authors": { "SS": ["Author1", "Author2"] }, "Dimensions": { "S": "8.5 x 11.0 x 1.5" }, "ISBN": { "S": "444-444444444" }, "Id": { "N": "104" }, "InPublication": { "BOOL": false }, "PageCount": { "N": "600" }, "Price": { "N": "2000" }, "ProductCategory": { "S": "Book" }, "Title": { "S": "Book 104 Title" } } } { "Item": { "Authors": { "SS": ["Author1", "Author2"] }, "Dimensions": { "S": "8.5 x 11.0 x 1.5" }, "ISBN": { "S": "555-5555555555" }, "Id": { "N": "105" }, "InPublication": { "BOOL": false }, "PageCount": { "N": "600" }, "Price": { "N": "2000" }, "ProductCategory": { "S": "Book" }, "Title": { "S": "Book 105 Title" } } }

Amazon Ion

Amazon Ion 是一种类型丰富、自我描述的分层数据序列化格式,旨在解决设计面向服务的大型体系时每天面临的快速开发、解耦和效率挑战。

导入 Ion 格式的数据时,Ion 数据类型将映射到新 DynamoDB 表中的 DynamoDB 数据类型。

Ion 到 DynamoDB 数据类型转换 B

1

Ion Data Type

DynamoDB Representation

2

string

String (s)

3

bool

Boolean (BOOL)

4

decimal

Number (N)

5

blob

Binary (B)

6

list (with type annotation $dynamodb_SS, $dynamodb_NS, or $dynamodb_BS)

Set (SS, NS, BS)

7

list

List

8

struct

Map

Ion 文件中的项目由换行符分隔。每行以 Ion 版本标记开头,后跟一个 Ion 格式的项目。

注意

在下面的示例中,为了提高可读性,Ion 格式文件的项目显示为多行。

$ion_1_0 { Item:{ Authors:$dynamodb_SS::["Author1","Author2"], Dimensions:"8.5 x 11.0 x 1.5", ISBN:"333-3333333333", Id:103., InPublication:false, PageCount:6d2, Price:2d3, ProductCategory:"Book", Title:"Book 103 Title" } }