调用CreateTable接口根据给定的表结构信息创建相应的数据表。
注意事项
-
创建成功的数据表并不能立刻提供读写服务。通常在建表成功后一分钟左右,即可对新创建的表进行读写操作。
-
单个实例下不能超过64个表。如果需要提高单实例下表数目的上限,请提交工单。
请求消息结构
message CreateTableRequest {
required TableMeta table_meta = 1;
required ReservedThroughput reserved_throughput = 2;
optional TableOptions table_options = 3;
optional StreamSpecification stream_spec = 5;
}
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
table_meta | TableMeta | 是 | 数据表的结构信息。其中table_name必须在本实例范围内唯一,primary_key的中ColumnSchema的个数应在1~4个范围内,primary_key中的ColumnSchema的name应符合命名规则和数据类型,type取值只能为STRING、INTEGER或者BINARY。关于命名规则和数据类型的更多信息,请参见命名规则和数据类型。
建表成功后,表的Schema将不能修改。 |
reserved_throughput | ReservedThroughput | 是 | 数据表的预留读吞吐量或者预留写吞吐量。任何表的预留读吞吐量与预留写吞吐量均不能超过100000。单位为CU。
数据表的预留读吞吐量或者预留写吞吐量设定可以通过UpdateTable进行更改。 |
table_options | TableOptions | 否 | 主要包括TimeToLive和最大版本数的设置。 |
stream_spec | StreamSpecification | 否 | 描述是否打开Stream相关的属性。 |
响应消息结构
message CreateTableResponse {
}
使用SDK
您可以使用如下语言的SDK创建数据表。