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

DeleteTable

重要

本节引用 API 版本 2011-12-05,此版本已被弃用且不应该用于新应用程序。

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

说明

DeleteTable 操作删除表及其所有项目。发出 DeleteTable 请求后,指定的表将一直处于 DELETING 状态,直到 DynamoDB 完成删除操作。如果表处于 ACTIVE 状态,则可以删除它。如果表处于 CREATINGUPDATING 状态,则 DynamoDB 将返回 ResourceInUseException 错误。如果指定的表不存在,则 DynamoDB 将返回 ResourceNotFoundException。如果表已处于 DELETING 状态,则不会返回错误。

注意

DynamoDB 可能会继续接受对处于 DELETING 状态的表发出的数据平面操作请求(如 GetItemPutItem),直到表删除操作完成。

在与发出请求的 AWS 账户和接收请求的 AWS 区域关联的这些表中,表是唯一的(如 dynamodb.us-west-1.amazonaws.com。每个 DynamoDB 终端节点都是完全独立的。举例来说,如果您有两个名为“MyTable”的表,一个位于 dynamodb.us-west-2.amazonaws.com 中,另一个位于 dynamodb.us-west-1.amazonaws.com 中,它们是完全独立的,并且不共享任何数据;删除其中一个表不会删除另一个表。

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

请求

语法

Copy
// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.DeleteTable content-type: application/x-amz-json-1.0 {"TableName":"Table1"}

名称 描述 必需
TableName

要删除的表的名称。

类型:字符串

响应

语法

Copy
HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Sun, 14 Aug 2011 22:56:22 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"DELETING" } }

名称 说明
TableDescription 表属性的容器。
CreationDateTime

创建表时的日期。

类型:数字

KeySchema

表的主键(简单或者复合)结构。HashKeyElement 的名称/值对是内容,而 RangeKeyElement 的名称/值对为可选内容(只有复合主键才需要该内容)。有关主键的更多信息,请参阅 主键

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

ProvisionedThroughput 指定的表的吞吐量,由 ReadCapacityUnitsWriteCapacityUnits 的值组成。请参阅读取和写入的吞吐量设置
ProvisionedThroughput: ReadCapacityUnits

在 DynamoDB 将此负载与其他操作进行平衡前,指定表的每秒占用的 ReadCapacityUnits 的最小数目。

类型:数字

ProvisionedThroughput: WriteCapacityUnits

在 DynamoDB 将此负载与其他操作进行平衡前,指定表的每秒占用的 WriteCapacityUnits 的最小数目。

类型:数字

TableName

已删除的表的名称。

类型:字符串

TableStatus 该表的当前状态 (DELETING)。删除该表后,对该表的后续请求将返回 resource not found

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

类型:字符串

特殊错误

错误 说明
ResourceInUseException 表处于 CREATINGUPDATING 状态,并且不能删除。

示例

示例请求

Copy
// This header is abbreviated. For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.DeleteTable content-type: application/x-amz-json-1.0 content-length: 40 {"TableName":"favorite-movies-table"}

示例响应

Copy
HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 160 Date: Sun, 14 Aug 2011 17:20:03 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}}, "TableName":"favorite-movies-table", "TableStatus":"DELETING" }