UpdateTable - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

UpdateTable

重要

This section refers to API version 2011-12-05, which is deprecated and should not be used for new applications.

有关当前低级别 API 的文档,请参阅 Amazon DynamoDB API Reference

Description

更新给定表的预置吞吐量。设置表的吞吐量可帮助您管理性能,并且是 DynamoDB 的预置吞吐量功能的一部分。有关更多信息,请参阅管理 DynamoDB 预置容量表的设置

预配置的吞吐量值可以根据Amazon DynamoDB 中的服务、账户和表配额中列出的最大值和最小值进行升级或降级。

该表必须处于 ACTIVE 状态,此操作才能成功。UpdateTable 是一个异步操作;在执行操作时,表处于 UPDATING 状态。当表处于 UPDATING 状态时,该表在调用前仍具有预置吞吐量。仅当表在 UpdateTable 操作后返回 ACTIVE 状态时,新的预置吞吐量设置才有效。

Requests

Syntax

// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }
名称 描述 必需
TableName

要更新的表的名称。

类型: 字符串

ProvisionedThroughput

指定表的新吞吐量,包含 ReadCapacityUnitsWriteCapacityUnits 的值。 请参阅管理 DynamoDB 预置容量表的设置

类型: 数组

ProvisionedThroughput :ReadCapacityUnits

为指定表设置在 ReadCapacityUnits 将负载与其他操作进行平衡之前,每秒使用的一致 DynamoDB 的最小数量。

最终一致性读取操作所需的工作量小于一致性读取操作所需的工作量,因此设置为每秒 50 个一致性 ReadCapacityUnits 可提供每秒 100 个最终一致性 ReadCapacityUnits

类型: 数字

ProvisionedThroughput :WriteCapacityUnits

为指定表设置在 WriteCapacityUnits 将负载与其他操作进行平衡之前,每秒使用的 DynamoDB 最小数。

类型: 数字

Responses

Syntax

HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG Content-Type: application/json Content-Length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"UPDATING"}}
名称 描述
CreationDateTime

创建表的日期。

类型: 数字

KeySchema

表的主键(简单或复合)结构。的名称-值对是必需的,HashKeyElement 的名称-值对是可选的(仅对于复合主键是必需的)。RangeKeyElement最大哈希键大小为 2048 个字节。最大范围键大小为 1024 个字节。两个限制是分开实施的 (即,您可以组合使用哈希 + 范围 2048 + 1024 键)。有关主键的更多信息,请参阅主键

类型: 复合主键的 HashKeyElementHashKeyElementRangeKeyElement 的映射。

ProvisionedThroughput

指定表的当前吞吐量设置,包括 LastIncreaseDateTime 的值(如果适用),LastDecreaseDateTime(如果适用)

类型: 数组

TableName

已更新的表的名称。

类型: 字符串

TableStatus 表的当前状态(CREATINGACTIVEDELETINGUPDATING),应为 UPDATING

使用 DescribeTables 操作检查表的状态。

类型: 字符串

特殊错误

错误 描述
ResourceNotFoundException 找不到指定的表。
ResourceInUseException 该表未处于 ACTIVE 状态。

Examples

示例请求

// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.UpdateTable content-type: application/x-amz-json-1.0 {"TableName":"comp1", "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15} }

示例响应

HTTP/1.1 200 OK content-type: application/x-amz-json-1.0 content-length: 390 Date: Sat, 19 Nov 2011 00:46:47 GMT {"TableDescription": {"CreationDateTime":1.321657838135E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput": {"LastDecreaseDateTime":1.321661704489E9, "LastIncreaseDateTime":1.321663607695E9, "ReadCapacityUnits":5, "WriteCapacityUnits":10}, "TableName":"comp1", "TableStatus":"UPDATING"} }