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

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

CreateTable

重要

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

操作向您的账户添加新表。CreateTable

表名称在与发出请求的 AWS 账户和接收请求的 AWS 区域(例如 dynamodb.us-west-2.amazonaws.com.cn)关联的账户中必须是唯一的。每个 DynamoDB 终端节点都完全独立。例如,如果您有两个名为“MyTable”的表,一个在 dynamodb.us-west-2.amazonaws.com.cn 中,另一个在 dynamodb.us-west-1 中,它们是完全独立的,不会共享任何数据。amazonaws.com.cn

操作触发异步工作流程以开始创建表。CreateTable 立即返回表的状态 (DynamoDB),直到表处于 CREATING 状态。ACTIVE一旦表处于 ACTIVE 状态,您就可以执行数据层面操作。

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

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.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"Table1", "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} }
名称 描述 必需
TableName

要创建的表的名称。

允许的字符包括 a-z、A-Z、0-9、“_”(下划线)、“-”(短划线)和“.”(点)。名称长度可以在 3 到 255 个字符之间。

类型: 字符串

KeySchema

表的主键(简单或复合)结构。的名称-值对是必需的,HashKeyElement 的名称-值对是可选的(仅对于复合主键是必需的)。RangeKeyElement有关主键的更多信息,请参阅主键

主键元素名称的长度可以在 1 到 255 个字符之间,没有字符限制。

的可能值为“S”(字符串)、“N”(数字)或“B”(二进制)。AttributeType

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

ProvisionedThroughput 指定表的新吞吐量,包含 ReadCapacityUnitsWriteCapacityUnits 的值。 有关详细信息,请参阅管理 DynamoDB 预置容量表的设置
注意

有关当前的最大/最小值,请参阅Amazon 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/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"CREATING" } }
名称 描述
TableDescription 表属性的容器。
CreationDateTime

UNIX 纪元时间中创建表的日期。

类型: 数字

KeySchema

表的主键(简单或复合)结构。的名称-值对是必需的,HashKeyElement 的名称-值对是可选的(仅对于复合主键是必需的)。RangeKeyElement有关主键的更多信息,请参阅主键

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

ProvisionedThroughput

指定表的吞吐量,由 ReadCapacityUnitsWriteCapacityUnits 的值组成。 请参阅管理 DynamoDB 预置容量表的设置

类型: 数组

ProvisionedThroughput :ReadCapacityUnits

ReadCapacityUnits 之前每秒使用的最小 DynamoDB 数。 使负载与其他操作平衡

类型: 数字

ProvisionedThroughput :WriteCapacityUnits

ReadCapacityUnits 之前每秒使用的最小 WriteCapacityUnits 数。 使负载与其他操作平衡

类型: 数字

TableName

创建的表的名称。

类型: 字符串

TableStatus

表的当前状态 (CREATING)。一旦表处于 ACTIVE 状态,您就可以将数据放入其中。

使用 DescribeTables API 检查表的状态。

类型: 字符串

特殊错误

错误 描述
ResourceInUseException 尝试重新创建已存在的表。
LimitExceededException

同时表请求数(处于 CREATINGDELETINGUPDATING 状态的表的累计数量)超过了允许的最大数量。

注意

有关当前的最大/最小值,请参阅Amazon DynamoDB 中的服务、账户和表配额

.

Examples

以下示例创建一个表,其中包含一个复合主键,其中包含一个字符串和一个数字。有关使用 AWS 开发工具包的示例,请参阅使用 DynamoDB 中的表和数据

示例请求

// This header is abbreviated. // For a sample of a complete header, see DynamoDB 低级 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.CreateTable content-type: application/x-amz-json-1.0 {"TableName":"comp-table", "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10} }

示例响应

HTTP/1.1 200 OK x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Tue, 12 Jul 2011 21:31:03 GMT {"TableDescription": {"CreationDateTime":1.310506263362E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}, "TableName":"comp-table", "TableStatus":"CREATING" } }