调用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。

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

table_options TableOptions 主要包括TimeToLive和最大版本数的设置。
stream_spec StreamSpecification 描述是否打开Stream相关的属性。

响应消息结构

message CreateTableResponse {
}

使用SDK

您可以使用如下语言的SDK创建数据表。