键值存储服务 KVS-创建表:请求参数

时间:2024-09-26 20:48:12

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

table_name

String

表名,仓内唯一。

bill_mode

String

表计费模式,可为"provisioned"或"on_demand"

  • 预置模式:provisioned

  • 按需模式:on_demand

provisioned_throughput

provisioned_throughput object

预置吞吐读写请求单元数,在bill_mode="provisioned"有效。

primary_key_schema

primary_key_schema object

主键模板, 最多1个,必须指定主键schema。

local_secondary_index_schema

Array of secondary_index objects

本地二级索引模板,可以多个。

global_secondary_index_schema

Array of global_secondary_index objects

全局二级索引模板。

pre_split_key_options

pre_split_key_options object

按照设定的分裂键值或者键值前缀进行预分裂。

说明:

range分区时该参数有效,且只作用于主表,其他场景无效。

表3 primary_key_schema

参数

是否必选

参数类型

描述

shard_key_fields

Array of field objects

分区键字段名数组,顺序组合。

shard_mode

String

分区模式。

sort_key_fields

Array of field objects

排序键字段名数组,顺序组合。

表4 secondary_index

参数

是否必选

参数类型

描述

index_name

String

二级索引名称,表内唯一。

sort_key_fields

Array of field objects

排序键字段名数组,顺序组合。

abstract_fields

Array of strings

摘要字段名数组。

表5 global_secondary_index

参数

是否必选

参数类型

描述

index_name

String

二级索引名称,表内唯一。

shard_key_fields

Array of field objects

分区键字段名数组,顺序组合。

shard_mode

String

分区模式。

sort_key_fields

Array of field objects

排序键字段名数组,顺序组合。

abstract_fields

Array of strings

摘要字段名数组。

provisioned_throughput

provisioned_throughput object

预置吞吐读写请求单元数,在bill_mode="provisioned"有效。

表6 field

参数

是否必选

参数类型

描述

name

String

字段名。

order

Boolean

bool值预留无意义。

表7 provisioned_throughput

参数

是否必选

参数类型

描述

rcu

Long

预置表级读请求单元数。

wcu

Long

预置表级写请求单元数。

表8 pre_split_key_options

参数

是否必选

参数类型

描述

range_split_points

Array of strings

在range分区模式有效,最大10个。

support.huaweicloud.com/api-kvs/CreateTable.html