根据给定的表结构信息创建相应的表。

请求结构

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

将要创建的表的初始预留读/写吞吐量设定,任何表的预留读吞吐量与预留写吞吐量均不能超过 5000。

表的预留读/写吞吐量设定可以通过 UpdateTable 进行动态更改。

table_options TableOptions

主要设置TimeToLive和最大版本数。

stream_spec StreamSpecification

描述是否打开Stream相关的属性。

响应消息结构

message CreateTableResponse {
}

注意事项

  • 创建成功的表并不能立刻提供读写服务。一般来讲,在建表成功后一分钟左右,即可对新创建的表进行读写操作。

  • 单个实例下不能超过 64 个表,如果需要提高单实例下表数目的上限,请提交工单