检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于创建表接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头
创建索引 操作场景 本章节指导用户在指定仓中创建指定表的索引。 前提条件 已成功创建要指定索引的表。 约束与限制 一个表支持创建5个本地二级索引和20个全局二级索引。 仅支持在创建表的过程中创建索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。
分区键和排序键有什么区别? 分区键和排序键之间的对比如表1所示 表1 分区键、排序键对比 对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。
查询索引 操作场景 本章节指导用户在指定表中查询索引。 前提条件 已成功创建要查询的索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 在仓列表中单击需要查询索引的表所在仓的名称。 在表列表中单击需要查询索引的表的名称,进入表详情页面。
扫描分区键内kv 功能介绍 指定表及分区键,携带条件查询kv;允许指定过滤条件。 URI POST /v1/scan-skey-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名,全域唯一,不同租户的仓名不能相同。 格式:${
批量写请求 功能介绍 批量写请求,其中可以携带一或多个表的不同kv的写操作,上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名,全域唯一,不同租户的仓名不能相同。
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时,HTTP请求返回一个3xx,4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。
SDK概述 本文介绍了KVS服务提供的SDK语言版本,列举了最新版本SDK的获取地址。 SDK列表 表1提供了KVS服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java h
索引简介 索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。键值写入时,自动生成并存储本
查询KV 操作场景 本章节指导用户查看指定表中的KV数据。 前提条件 要查看的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入对应仓,单击表名进入对应表。 选择“KV信息”页签。 在KV列表上方搜索框中选择“属性类型
产品功能 表1列出了KVS提供的主要功能特性。 表1 KVS功能概览 功能名称 功能描述 存储仓管理 存储仓是用来存储表数据的单元。用户可以根据自己的业务系统划分,创建不同的仓。支持创建、查询存储仓。 表管理 表是用来存储键值数据的集合,归属于某个仓。用户可以在一个仓中创建一个或
按需计费 按需计费是一种先使用再付费的计费模式,适用于无需任何预付款或长期承诺的用户。本文将介绍KVS按需计费资源的计费规则。 适用场景 按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务。 适用计费项 以下计费项支持按需计费。 表1 适用计费项 计费项 单价 说明 存储费用
预置计费 预置计费是一种先使用再付费的计费模式,适用于无需任何预付款、长期承诺或希望控制成本的用户。 使用该模式,需要用户在创表时能够预估应用每秒读/写KVS的吞吐量,并设置到表中,当该表读/写的每秒吞吐量超过该预置值时,请求默认将被限流。 本文将介绍KVS预置计费资源的计费规则。
与其他服务的关系 KVS与周边服务的依赖关系如图1所示。具体的交互功能请参考表1。 图1 KVS与其他服务的关系 表1 KVS与其他服务的关系 服务名称 KVS与其他服务的关系 主要交互功能 云监控服务(Cloud Eye Service,CES) CES实时采样KVS的监控指标
删除KV 操作场景 本章节指导用户删除指定KV。 前提条件 要删除的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要删除KV的仓,单击表名进入要删除KV的表。 选择“KV信息”页签。 找到要删除的KV,在右侧操作列,单击“删除”。
存储费用 在使用键值存储服务时,按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据(所有KV和索引)所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
计费样例 计费场景 某游戏公司需要存储名下一款游戏的用户信息、排行榜、装备、游戏状态等数据,于是该游戏公司在2024/04/30 8:00:00在华北-北京四区域创建了一个存储仓exampleprefix-cn-north-4-exampledomainid,并在这个存储仓下创建了一张exampletable
约束与限制 存储仓限制 存储仓名称长度范围为16-52个字符,字母大小写不敏感,不能包含“.”,且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。 表限制
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考:查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下:
更新KV 操作场景 本章节指导用户更新指定KV。 前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要更新KV的仓,单击表名进入要更新KV的表。 选择“KV信息”页签。