赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. API参考(数据管理)
  6. API概览
  7. 数据表操作
  8. CreateTable

CreateTable

  • 数据表操作
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

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

  • Java SDK:创建数据表

  • Go SDK:创建数据表

  • Python SDK:创建数据表

  • Node.js SDK:创建数据表

  • .NET SDK:创建数据表

  • PHP SDK:创建数据表

相关文章

CreateTable 2025-04-22 14:34

调用CreateTable接口根据给定的表结构信息创建相应的数据表。 注意事项

ListTable 2025-04-22 14:34

调用ListTable接口获取当前实例下已创建的所有表的表名。 注意事项 如果一个表刚刚创建成功,该表名会出现在ListTableRespon

DescribeTable 2025-04-22 14:34

调用DescribeTable接口查询指定表的结构信息以及预留读吞吐量和预留写吞吐量设置信息。 请求消息结构

UpdateTable 2025-04-22 14:34

您可以调用 UpdateTable 接口修改表的配置信息 table_options 和 Stream 配置 StreamSpecification。如果表处于CU 模式(原按量模式)的高性能型实例中,您还可以为数据表配置预留读/写吞吐量

DeleteTable 2025-04-22 14:34

调用DeleteTable接口删除本实例下指定的表。 请求消息结构

ComputeSplitPointsBySize 2025-04-22 14:34

调用ComputeSplitPointsBySize接口将全表的数据在逻辑上划分成接近指定大小的若干分片,返回这些分片之间的分割点以及分片所在机器的提示。一般用于计算引擎规划并发度等执行计划。 请求消息结构

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号