Amazon DynamoDB 中的服务、账户和表限额

如果要为配置为使用超过 4 万个写入容量单位 (WCU) 的表添加副本，则必须针对添加副本的 WCU 配额请求提高服务配额。

如果要在 24 小时内将副本添加到超过 10TB 的目标区域，则必须针对添加副本数据回填配额请求提高服务配额。

如果您遇到类似以下内容的错误消息：

无法在区域“example_region_A”中创建表“example_table”的副本，因为它超过了您在区域“example_region_B”中的当前账户限制。

您最多可以定义 5 个本地二级索引。

每个表都有 20 个全局二级索引的原定设置限额。您可以使用 Service Quotas 控制台 、 AWS API 和 AWS CLI 查看为账户申请的每个表的全局二级索引数的默认和当前配额，并在需要时请求提高配额。您还可以通过向 https://aws.amazon.com/support 开设票证来请求提高配额。

您只能为每个 UpdateTable 操作创建或删除一个全局二级索引。

您最多可将 100 个属性投影到表的所有本地和全局二级索引，此限制只适用于用户指定的投影属性。

在 CreateTable 操作中，如果您指定 INCLUDE 的 ProjectionType ，则 NonKeyAttributes 中指定的属性总数量（所有二级索引的属性之和）不能超过 100。如果您将同一属性名称投影到两个不同的索引中，就会在确定总量时计为两个不同的属性。

此限制不适用于具有 ProjectionType 为 KEYS_ONLY 或 ALL 的二级索引。

分区键和排序键

分区键长度

分区键值的最小长度为 1 个字节，最大长度为 2048 个字节。

表和二级索引的不同分区键值的数量没有实际限制。

排序键长度

排序键值的最小长度为 1 个字节。最大长度为 1024 个字节。

一般情况下，每个分区键值的不同排序键值的数量没有实际限制。

具有二级索引的表则例外。项目集合是一组具有相同分区键属性值的项目。在全局二级索引中，项目集合独立于基表（并可以具有不同的分区键属性），但在本地二级索引中，索引视图与表中的项目位于同一个分区中，并且共享相同的分区键属性。由于这种本地性质，当一个表有一个或多个 LSI 时，项目集合不能分布到多个分区。

对于包含一个或多个 LSI 的表，项目集合的大小不能超过 10GB。这包括所有基表项目和具有相同分区键属性值的所有投影 LSI 视图。10GB 是分区的最大大小。有关更多详细信息，请参阅 项目集合大小限制 。

二级索引排序键名称。

任意用户指定的投影属性的名称（仅适用于本地二级索引）。在 CreateTable 操作中，如果您将 ProjectionType 指定为 INCLUDE ，那么 NonKeyAttributes 参数中属性名称的长度就有限制。 KEYS_ONLY 和 ALL 投影类型不受此影响。

这些属性名称必须使用 UTF-8 进行编码，并且每个名称 (编码后) 的总大小不能超过 255 字节。

字符串的长度会受到 400 KB 的最大项目大小限制。

字符串是使用 UTF-8 二进制编码的 Unicode。由于 UTF-8 是宽度可变的编码，因此 DynamoDB 使用其 UTF-8 字节确定字符串的长度。

数字最多可精确到 38 位，并且可以为正数、负数或零。

正数范围： 1E-130 到 9.9999999999999999999999999999999999999E+125

负数范围： -9.9999999999999999999999999999999999999E+125 到 -1E-130

DynamoDB 使用 JSON 字符串代表请求和回复中的数字数据。有关更多信息，请参阅 DynamoDB 低级 API 。

如果数字精度十分重要，则应使用从数字类型转换的字符串将数字传递给 DynamoDB。

二进制的长度会受到项目大小上限 400 KB 的限制。

使用二进制属性的应用程序必须先用 Base64 格式对数据进行编码，然后将其发送至 DynamoDB。接收到数据后，DynamoDB 将数据解码为无符号字节数组，将其用作属性的长度。

DynamoDB 中的项目大小上限为 400 KB，包括属性名称二进制长度（UTF-8 长度）和属性值长度（同为二进制长度）。属性名称也包含在此大小限制之内。

例如，比如一个项目有两个属性：一个属性名为“shirt-color”，值为“R”，另一个属性名为“shirt-size”，值为“M”。该项目的总大小为 23 字节。

具有本地二级索引的表的项目大小

对于表上的每个本地二级索引，以下对象的总大小有 400 KB 的限制：

表达式参数

表达式参数包括 ProjectionExpression 、 ConditionExpression 、 UpdateExpression 和 FilterExpression 。

任何表达式字符串的最大长度均为 4KB。例如， ConditionExpression a=b 的大小是 3 个字节。

任何一个表达式属性名称或表达式属性值的最大长度均为 255 字节。例如， #name 是 5 个字节； :val 是 4 个字节。

表达式中所有替代变量的最大长度为 2 MB。这是所有 ExpressionAttributeNames 和 ExpressionAttributeValues 的长度之和。

运算符数和操作数

UpdateExpression 中允许的运算符或函数的最大数量为 300。例如， UpdateExpression SET a = :val1 + :val2 + :val3 包括两个“ + ”运算符。

IN 比较器的操作数最大数量为 100。

DynamoDB 不会阻止您使用与保留字冲突的名称。(有关完整列表，请参阅 DynamoDB 中的保留字 。)

但是，如果您在表达式参数中使用了保留字，则还必须指定 ExpressionAttributeNames 。有关更多信息，请参阅 DynamoDB 中的表达式属性名称 。

DynamoDB 事务

DynamoDB 事务 API 操作具有以下约束：

一个事务不能包含超过 4 MB 数据。

不能对同一个表中的同一个项目执行事务中的两个操作。例如，您不能在一个事务中对同一个项目同时执行 ConditionCheck 和 Update 。

事务无法对超过一个 AWS 账户或区域中的表执行操作。

事务操作仅在最初写入的 AWS 区域内提供原子性、一致性、隔离性和持久性 (ACID) 保证。全局表中不支持跨区域的事务。例如，假设您在美国东部（俄亥俄）和美国西部（俄勒冈）区域有一个带副本的全局表，并且您在美国东部（弗吉尼亚北部）区域执行 TransactWriteItems 操作。在此情况下，您可能会在复制更改时观察到美国西部（俄勒冈）区域内已部分完成的事务。更改仅在源区域中提交后才复制到其他区域。

DynamoDB Streams

DynamoDB Streams 中的分片同时读取器

对于作为非全局表的单区域表，您可以设计最多两个进程来同时从同一个 DynamoDB Streams 分区读取数据。超过此限制会导致请求被拒。对于全局表，我们建议您将并行读取器的数量限制为一个，以避免请求节流。

您可以使用 Service Quotas 控制台 、 AWS API 和 AWS CLI 查看应用于账户的已启用 DynamoDB Streams 的表的最大写入容量默认和当前配额，并在需要时请求提高配额。您也可以通过向 AWS Support 开设票证来请求提高配额。

DynamoDB Accelerator (DAX)

AWS 区域可用性

有关提供 DAX 的 AWS 区域，请参阅《AWS 一般参考》 中的 DynamoDB Accelerator (DAX) 。

通常，您可以按任意组合同时运行多达 500 个 CreateTable 、 UpdateTable 和 DeleteTable 请求。因此，处于 CREATING 、 UPDATING 或 DELETING 状态的表的总数不能超过 500 个。

您可以跨表组，以任意组合提交每秒多达 2500 个可变（ CreateTable 、 DeleteTable 、 UpdateTable ）控制面板 API 请求的请求。针对同一个表的并发可变请求可能会在较低的限制下受到节流。

您可以使用 Service Quotas 控制台 、 AWS API 和 AWS CLI 查看并发控制面板操作的默认和应用的配额值，并在需要时请求提高配额。您也可以通过向 AWS Support 开设票证来请求提高配额

静态 DynamoDB 加密

从创建表开始，每 24 小时时段，允许在 AWS 拥有的密钥、AWS 托管式密钥 和客户托管密钥之间以每个表为基础切换最多四次。此外，如果过去 6 小时内未执行任何更改，则可以执行额外的更改。这实际上将每日的更改操作的最大次数设置为 8 次（在前 6 个小时内为 4 次更改操作，对于一天内的每个后续 6 小时时段，为 1 次更改操作）。

您可以根据需要切换加密密钥以使用 AWS 拥有的密钥，即使上述配额已用尽。

相关配额如下，但您也可以请求提高配额。要请求提高服务配额，请参阅 https://aws.amazon.com/support 。