Amazon DynamoDB
开发人员指南 (API 版本 2012-08-10)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

使用二级索引改进数据访问

Amazon DynamoDB 通过指定主键值来提供对表中项目的快速访问。但是,很多应用程序可能适合有一个或多个二级(或替代)键,以便通过主键以外的属性对数据进行高效访问。要解决此问题,您可以对表创建一个或多个二级索引,然后对这些索引发出 QueryScan 请求。

二级索引 是一种数据结构,它包含表中属性的子集以及一个支持 Query 操作的替代键。您可以使用 Query 从索引中检索数据,其方式与对表使用 Query 大致相同。一个表可以有多个二级索引,这样,应用程序可以访问许多不同的查询模式。

注意

也可以对索引使用 Scan,其方式与对表使用 Scan 大致相同。

每个 二级索引 关联且仅关联一个表,并从该表中获取其数据。这称为索引的基表。在创建索引时,您为索引定义一个替代键 (分区键和排序键)。您还需要定义从基表投影 或复制到索引的属性。DynamoDB 将这些属性与基表中的主键属性一起复制到索引中。然后,您可以查询或扫描该索引,就像查询或扫描表一样。

每个二级索引都由 DynamoDB 自动维护。在基表中添加、修改或删除项目时,表上的所有索引也会更新,以反映这些更改。

DynamoDB 支持两种二级索引:

  • Global secondary index 其分区键和排序键可以与基表上的分区键和排序键不同的索引。全局二级索引被视为“全局”,是因为对索引执行的查询可以跨基表中所有分区的所有数据。

  • 本地二级索引 分区键与基表相同、但排序键不同的索引。local secondary index的含义是“本地”,表示local secondary index的每个分区的范围都将限定为具有相同分区键值的基表分区。

在确定要使用的索引类型时,应考虑应用程序的要求。下表是全局二级索引与local secondary index的主要差异:

特征 全局二级索引 本地二级索引
键架构 全局二级索引的主键可以是简单主键(分区键)或复合主键(分区键和排序键)。 local secondary index的主键必须是复合主键(分区键和排序键)。
键属性 索引分区键和排序键 (如果有) 可以是字符串、数字或二进制类型的任何基表属性。 索引的分区键是与基表的分区键相同的属性。排序键可以是字符串、数字或二进制类型的任何基表属性。
每个分区键值的大小限制 全局二级索引没有大小限制。 对于每个分区键值,所有索引项目的大小总和必须为 10GB 或更小。
在线索引操作 您可以在创建表时创建Global secondary index。您也可以向现有表添加新全局二级索引,或者删除现有全局二级索引。有关更多信息,请参阅管理全局二级索引 本地二级索引是在创建表的同时创建的。您不能向现有表添加local secondary index,也不能删除已存在的任何local secondary index。
查询和分区 通过全局二级索引,可以跨所有分区查询整个表。 借助local secondary index,您可以对查询中分区键值指定的单个分区进行查询。
读取一致性 对全局二级索引进行的查询仅支持最终一致性。 查询local secondary index时,您可以选择最终一致性或强一致性。
预置吞吐量使用 每个全局二级索引都有自己的用于读取和写入活动的预置吞吐量设置。对全局二级索引执行的查询或扫描会占用索引 (而非基表) 的容量单位。全局二级索引更新也是如此,因为会进行表写入。 对local secondary index执行的查询或扫描会占用基表的读取容量单位。向表写入时,其local secondary index也会更新;这些更新会占用基表的写入容量单位。
投影属性 对于全局二级索引查询或扫描,您只能请求投影到索引的属性。DynamoDB 不会从表中获取任何属性。 如果您查询或扫描local secondary index,则可以请求未投影到索引的属性。DynamoDB 会自动从表中获取这些属性。

如果要创建多个含有二级索引的表,必须按顺序执行此操作。例如,您可以创建第一个表,等待其状态变为 ACTIVE,创建下一个表,等待其状态变为 ACTIVE,依此类推。如果您尝试同时创建多个含有二级索引的表,DynamoDB 会返回 LimitExceededException

对于每个二级索引,必须指定以下内容:

  • 要创建的索引的类型 – 全局二级索引或local secondary index。

  • 索引的名称。索引的命名规则与表的命名规则相同,具体请参阅 DynamoDB 中的限制。就相关联的基表而言,索引的名称必须唯一,不过,与不同的基表相关联的索引的名称可以相同。

  • 索引的键架构。索引键架构中的每个属性必须是类型为字符串、数字或二进制的顶级属性。其他数据类型,包括文档和集,均不受支持。键架构的其他要求取决于索引的类型:

    • 对于全局二级索引,分区键可以是基表的任何标量属性。排序键是可选的,也可以是基表的任何标量属性。

    • 对于local secondary index,分区键必须与基表的分区键相同,排序键必须是非键基表属性。

  • 要从基表投影到索引中的其他属性 (如果有)。这些属性是除表键属性之外的属性,表键属性会自动投影到每个索引。您可以投影任何数据类型的属性,包括标量、文档和集。

  • 索引的预置吞吐量设置(如有必要):

    • 对于全局二级索引,您必须指定读取和写入容量单位设置。这些预置吞吐量设置独立于基表的设置。

    • 对于local secondary index,您无需指定读取和写入容量单位设置。对local secondary index进行的读取和写入操作会占用其基表的预置吞吐量设置。

为获得最大查询灵活性,您可以为每个表创建多达 5 个全局二级索引和多达 5 个local secondary index。有关演示如何利用有限数量的 GSI 满足多个应用程序访问模式的示例,请参阅 GSI 重载的设计指南。

要获取表的二级索引的详细列表,请使用 DescribeTable 操作。DescribeTable 将返回表的每个二级索引的名称、存储大小和项目计数。系统并不会实时更新这些值,但会大约每隔六个小时刷新一次。

您可以使用 QueryScan 操作来访问二级索引中的数据。您必须指定您要使用的基表的名称和索引的名称、要在结果中返回的属性以及要应用的任何条件表达式或筛选条件。DynamoDB 可按升序或降序返回结果。

删除表时,会同时删除与该表关联的全部索引。

有关最佳实践,请参阅 在 DynamoDB 中使用二级索引的最佳实践