全部产品
Search
文档中心

表格存储:CreateTable

更新时间:Nov 09, 2023

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

数据表的结构信息。具体配置项如下:

重要

建表成功后,表的Schema将不能修改。

  • table_name:表名,必须在本实例范围内唯一。

  • primary_key:主键信息,主键的中ColumnSchema的个数应在1~4个范围内,primary_key中的ColumnSchema的name应符合命名规则和数据类型,type取值只能为STRING、INTEGER或者BINARY。关于命名规则和数据类型的更多信息,请参见命名规则和数据类型

  • defined_Columns:预定义列信息。如果要使用二级索引,您需要为数据表添加预定义列,预先定义一些非主键列以及其类型作为索引表的属性列或索引列。您也可以建表后单独添加预定义列。具体操作,请参见如何使用预定义列

reserved_throughput

ReservedThroughput

数据表的预留读吞吐量或者预留写吞吐量。任何表的预留读吞吐量与预留写吞吐量均不能超过100000。单位为CU

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

table_options

TableOptions

主要包括TimeToLive、最大版本数等的设置。

stream_spec

StreamSpecification

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

响应消息结构

message CreateTableResponse {
}

使用SDK

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