调用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创建数据表。