全部產品
Search
文件中心

Tablestore:CreateTable

更新時間:Jun 30, 2024

調用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建立資料表。