DynamoDB - API 接口



DynamoDB 提供了一套强大的 API 工具,用于表操作、数据读取和数据修改。

亚马逊建议使用AWS SDK(例如,Java SDK),而不是直接调用底层 API。这些库使得直接与底层 API 交互变得不必要。这些库简化了诸如身份验证、序列化和连接之类的常见任务。

操作表

DynamoDB 提供了五个用于表管理的底层操作:

  • CreateTable - 创建一个表,包括用户设置的吞吐量。它要求设置主键(复合主键或简单主键),并且允许一个或多个二级索引。

  • ListTables - 提供当前 AWS 用户帐户及其端点关联的所有表的列表。

  • UpdateTable - 修改吞吐量和全局二级索引吞吐量。

  • DescribeTable - 提供表元数据;例如,状态、大小和索引。

  • DeleteTable - 简单地删除表及其索引。

读取数据

DynamoDB 提供了四个用于数据读取的底层操作:

  • GetItem - 它接受一个主键并返回相关项目的属性。它允许更改其默认的最终一致性读取设置。

  • BatchGetItem - 通过主键对多个项目执行多个 GetItem 请求,可以选择一个或多个表。它的返回项目不超过 100 个,并且必须小于 16MB。它允许最终一致性读取和强一致性读取。

  • Scan - 读取所有表项并生成最终一致的结果集。您可以通过条件过滤结果。它避免使用索引并扫描整个表,因此不要将其用于需要可预测性的查询。

  • Query - 返回单个或多个表项或二级索引项。它使用分区键的指定值,并允许使用比较运算符来缩小范围。它支持两种类型的一致性,每个响应的大小限制为 1MB。

修改数据

DynamoDB 提供了四个用于数据修改的底层操作:

  • PutItem - 创建一个新项目或替换现有项目。如果发现相同的主键,默认情况下它会替换该项目。条件运算符允许您绕过默认设置,并且仅在特定条件下替换项目。

  • BatchWriteItem - 执行多个 PutItem 和 DeleteItem 请求,以及多个表上的请求。如果一个请求失败,它不会影响整个操作。它的上限为 25 个项目和 16MB 的大小。

  • UpdateItem - 更改现有项目的属性,并允许使用条件运算符仅在特定条件下执行更新。

  • DeleteItem - 它使用主键删除项目,并且还允许使用条件运算符指定删除条件。

广告