阅读741 返回首页    go 阿里云


CreateTable__API 概览_API 参考_表格存储-阿里云

行为:

根据给定的表结构信息创建相应的表。

请求结构:

  1. message CreateTableRequest {
  2. required TableMeta table_meta = 1;
  3. required ReservedThroughput reserved_throughput = 2;
  4. }

table_meta:

  • 类型:TableMeta

  • 是否必要参数:是。

  • 将要创建的表的结构信息,其中 table_name 应在本实例范围内唯一;primary_key 的中 ColumnSchema 的个数应在 1~4 个范围内;primary_key 中的 ColumnSchema 的 name 应符合表名命名规范,type 取值只能为 STRING 或 INTEGER。

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

reserved_throughput:

  • 类型:ReservedThroughput

  • 是否必要参数:是。

  • 将要创建的表的初始预留读/写吞吐量设定,任何表的预留读吞吐量与预留写吞吐量均不能超过 5000。

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

响应消息结构:

  1. message CreateTableResponse {
  2. }

注意事项:

  • 创建成功的表并不能立刻提供读写服务。一般来讲,在建表成功后一分钟左右,即可对新创建的表进行读写操作。

  • 单个实例下不能超过 64 个表,如果需要提高单实例下表数目的上限,请使用人工服务提高此限额。

请求示例:

  1. CreateTableRequest {
  2. table_meta {
  3. table_name: "consume_history"
  4. primary_key {
  5. name: "CardID"
  6. type: STRING
  7. }
  8. primary_key {
  9. name: "SellerID"
  10. type: STRING
  11. }
  12. primary_key {
  13. name: "DeviceID"
  14. type: STRING
  15. }
  16. primary_key {
  17. name: "OrderNumber"
  18. type: INTEGER
  19. }
  20. }
  21. capacity_unit {
  22. read: 100
  23. write: 100
  24. }
  25. }

响应示例:

  1. CreateTableResponse {
  2. }

最后更新:2016-11-23 16:03:56

  上一篇:go BatchWriteRow__API 概览_API 参考_表格存储-阿里云
  下一篇:go ListTable__API 概览_API 参考_表格存储-阿里云