Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

DynamoDB API

要使用 Amazon DynamoDB,您的应用程序必须使用一些简单的 API 操作。下面汇总了这些操作 (按类别组织)。

控制层面

控制层面 操作可让您可以创建和管理 DynamoDB 表。它们还可让您可以使用依赖于表的索引、流和其他对象。

  • CreateTable - 创建新表。或者,您也可以创建一个或多个二级索引并为表启用 DynamoDB 流。

  • DescribeTable - 返回有关表的信息,例如,表的主键架构、吞吐量设置、索引信息等。

  • ListTables - 返回列表中您的所有表的名称。

  • UpdateTable - 修改表或其索引的设置、创建或删除表上的新索引或修改表的 DynamoDB 流 设置。

  • DeleteTable - 从 DynamoDB 中删除表及其所有依赖对象。

数据层面

数据层面 操作可让您对表中的数据执行创建、读取、更新和删除 (也称为 CRUD) 操作。某些数据层面操作还可让您可以从二级索引中读取数据。

创建数据

  • PutItem - 将单个项目写入到表中。您必须指定主键属性,但不必指定其他属性。

  • BatchWriteItem - 将最多 25 个项目写入到表中。这比多次调用 PutItem 更有效,因为您的应用程序只需一个网络往返行程即可写入项目。您还可以使用 BatchWriteItem 来从一个或多个表中删除多个项目。

读取数据

  • GetItem - 从表中检索单个项目。您必须为所需的项目指定主键。您可以检索整个项目,也可以仅检索其属性的子集。

  • BatchGetItem - 从一个或多个表中检索最多 100 个项目。这比多次调用 GetItem 更有效,因为您的应用程序只需一个网络往返行程即可读取项目。

  • Query - 检索具有特定分区键的所有项目。您必须指定分区键值。您可以检索整个项目,也可以仅检索其属性的子集。或者,您也可以对排序键值应用条件,以便只检索具有相同分区键的数据子集。您可以对表使用此操作,前提是该表同时具有分区键和排序键。您还可以对索引使用此操作,前提是该索引同时具有分区键和排序键。

  • Scan - 检索指定表或索引中的所有项目。您可以检索整个项目,也可以仅检索其属性的子集。或者,您也可以应用筛选条件以仅返回您感兴趣的值并放弃剩余的值。

更新数据

  • UpdateItem - 修改项目中的一个或多个属性。您必须为要修改的项目指定主键。您可以添加新属性并修改或删除现有属性。您还可以执行有条件更新,以便更新仅在满足用户定义的条件时成功。或者,您也可以实施一个原子计数器,该计数器可在不干预其他写入请求的情况下递增或递减数字属性。

删除数据

  • DeleteItem - 从表中删除单个项目。您必须为要删除的项目指定主键。

  • BatchWriteItem - 从一个或多个表中删除最多 25 个项目。这比多次调用 DeleteItem 更有效,因为您的应用程序只需一个网络往返行程即可删除项目。您也可以使用 BatchWriteItem 来向一个或多个表添加多个项目。

DynamoDB 流

DynamoDB 流 操作可让您对表启用或禁用流,并能允许对包含在流中的数据修改记录的访问。

  • ListStreams - 返回您的所有流的列表,或仅返回特定表的流。

  • DescribeStream - 返回有关流的信息,例如,流的 Amazon 资源名称 (ARN) 和您的应用程序可开始读取前几条流记录的位置。

  • GetShardIterator - 返回一个分区迭代器,这是您的应用程序用来从流中检索记录的数据结构。

  • GetRecords - 使用给定分区迭代器检索一条或多条流记录。