检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建表 功能介绍 在指定仓内创建表，表名在仓内唯一；创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。创建表时，如果仓不存在，将会自动创建仓。 URI POST /v1/create-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name
步骤六：创建表（同时指定索引） 操作场景 表是用来存储键值数据的集合，在插入KV数据前需要先创建表。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来创建表。 操作步骤 表1 不同访问方式创建表的方法 访问方式 创建表方法 控制台 通过控制台创建表 SDK 通过SDK创建表
”和“$”。“X”字符为前缀的字段名称为系统预留字段名称，目前系统预留字段名称包括“Xattr”和“Xblob”，不建议您使用作为字段名。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名进入要插入KV的仓，单击表名进入要插入KV的表。 选择“KV信息”页签。
根据界面提示，配置“表详细信息”参数。 图2 “表详细信息”界面 表2 “表详细信息”参数说明 类别 参数名称 描述 表详细信息 表名称 必选参数。 表的名称。表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。
Document 新增字段或覆盖1个或多个字段的值。 说明： 禁止修改sortkey的字段。 add 否 Document 对1个或多个字段做加法运算，并更新为运算后的值。 rmv 否 Array of strings 删除1个或多个字段。 数组元素为待删除字段名。 insert 否
KVS云服务支持创建表，查询所有表及详细信息。 表1 KVS云服务支持的表相关功能 功能 描述 创建表 在指定存储仓创建表，同时指定索引。 查询表 在指定存储仓查询所有表。 查询表详细信息 在指定存储仓查看某个表的详情 父主题： 表管理
本地二级索引和全局二级索引之间的对比如表1所示。 每个索引属于一个表，该表称为索引的主表。 表1 本地二级索引、全局二级索引对比 对比维度 本地二级索引 全局二级索引 概念 对于复合主键（分区键+排序键）的表，支持创建本地二级索引，实现分区键下的多个键值的辅助索引。 表支持创建非主键字段的全局检索，全局
的强一致。 全局二级索引 表支持创建非主键字段的全局检索，全局二级索引只保存索引记录，不保存完整键值内容。键值写入时，自动生成索引记录，并异步写入全局二级索引，键值与全局二级索引记录为最终一致。 图1 索引简介 KVS云服务支持创建、查询、删除索引。 表1 KVS云服务支持的索引相关功能
用户自定义的主键名及值。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 kv_doc Document 对kv_doc有效。 说明： 内容字段：主键字段+投影字段或者全部字段。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code
效。 表7 field 参数 参数类型 描述 name String 字段名。 order Boolean bool值预留无意义。 表8 provisioned_throughput 参数 参数类型 描述 rcu Long 预置表级读请求单元数。 wcu Long 预置表级写请求单元数。
composed_expression object 组合条件, 逐层同级的子表达式嵌套。 表4 multi_field_expression 参数 是否必选 参数类型 描述 logic 否 String 多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of sin
本章节指导用户在指定仓中创建指定表的索引。 前提条件 已成功创建要指定索引的表。 约束与限制 一个表支持创建5个本地二级索引和20个全局二级索引。 仅支持在创建表的过程中创建索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要创建索
composed_expression object 组合条件, 逐层同级的子表达式嵌套。 表4 multi_field_expression 参数 是否必选 参数类型 描述 logic 否 String 多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of sin
composed_expression object 组合条件, 逐层同级的子表达式嵌套。 表4 multi_field_expression 参数 是否必选 参数类型 描述 logic 否 String 多字段条件，多个相同优先级的单字段条件。 expressions 是 Array of sin
本章节指导用户在创建表的过程中删除指定索引。 前提条件 在创建表的过程中，已指定索引且未完成表的创建。 约束与限制 目前仅支持在创建表的过程中删除索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到需要删除索引的表所在的仓，在
e、start_key和end_key字段配合使用。Range分区模式下支持全表采样和范围采样；Hash分区模式仅支持全表扫描。 仅支持对Primary key进行采样，不支持本地/全局二级索引。 返回的段列表仅包含主键，不包含键值；且段列表是编码后的数据 ，不可修改。 return_count_only
据存储在表中。 分区键和排序键 分区键：分区键是一个表的属性，用于确定该表中的每一个KV存储所在的分区。例如，对于一个用户表，可以指定用户名属性作为分区键。 KVS会根据此用户名的名称（KV）选择分区，同样的用户名名称存储在同一个分区。 排序键：排序键是一个表的属性，该表中的KV
”和“$”。“X”字符为前缀的字段名称为系统预留字段名称，目前系统预留字段名称包括“Xattr”和“Xblob”，不建议您使用作为字段名。 主键总长不超过1200个字节，且主键必须唯一。 使用API请求方式访问的KV，只能属于一个存储仓。 一个KV一定归属于某个表。 仓+表+主键可以唯一定位一条KV。
成本，拥有云账号即可实现键值的存取。 存储结构灵活 支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引，提升检索效率； 支持前缀遍历，提升遍历效率。 数据高可用 提供区域内多可用区的同步读写，任一可用区故障均不影响业务；
其中${store-name}为仓名。 请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
