检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
基本概念 键值存储服务基本概念 区域和可用区
存储仓管理 存储仓简介 创建存储仓 查询存储仓列表 查询存储仓详细信息
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
概述 欢迎使用键值存储服务（Key-Value Storage Service, KVS）。键值存储服务提供完全托管的键值存储及索引服务，主要用于应用的键值类数据（如：元数据、描述数据、管理参数、状态数据）的存储，提供可预测的性能和无缝扩展，无需进行分区管理、硬件预置、集群扩展等操作。
请求费用 通过控制台、API等任意方式对KVS进行操作，实际上都是对KVS API的调用，每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式，当表读/写的每秒吞吐量超过预置值时，请求默认将被限流，费用按预置吞吐量计算。
存储费用 在使用键值存储服务时，按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据（所有KV和索引）所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
创建表 操作场景 本章节指导用户在指定存储仓创建表，同时指定索引。 前提条件 已成功创建要创建表的存储仓。 约束与限制 单个存储仓下可以创建的表数量不超过100个。 一个表一定归属于某个存储仓。 表的名称长度范围为3-52个字符，由数字0-9、字符a-z、A-Z，及特殊符“-”、“_”组成，且表的名称在存储仓内唯一。
查询表 操作场景 本章节指导用户在指定存储仓内查询表。 前提条件 已成功创建要查询的表。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 单击仓名称，进入仓详情页面。 在“表信息”下的搜索框中选择“属性类型 > 表名称”，或者输入关键字
索引简介 索引是用来辅助查询表中的KV数据，能够加速键值检索，准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键（分区键+排序键）的表，支持创建本地二级索引，实现分区键下的多个键值的辅助索引。键值写入时，自动生成并存储本
删除索引 操作场景 本章节指导用户在创建表的过程中删除指定索引。 前提条件 在创建表的过程中，已指定索引且未完成表的创建。 约束与限制 目前仅支持在创建表的过程中删除索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中找到
修订记录 发布日期 修订记录 2024-04-30 第一次正式发布。
仓接口 列举仓 创建表 列举表 父主题： API
计费模式 云服务通常包含至少两种基本计费模式：包年/包月和按需计费。因此，在写作计费模式章节时，需要分多个子章节来分别介绍这些不同的计费模式。在计费模式概述章节中，应提供多种计费模式的对比。此外，如果云服务还涉及套餐包/流量包/资源包等优惠包，或者免费额度等计费模式，也都应在计费文档中包含。
约束与限制 存储仓限制 存储仓名称长度范围为16-52个字符，字母大小写不敏感，不能包含“.”，且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。 表限制
应用场景 广告场景 使用KVS存储各种营销数据，如：用户资料、用户事件、点击和访问的链接等。使用这些数据可以进行实时出价、广告定位等。 游戏场景 使用KVS存储游戏状态、玩家数据、会话历史记录和排行榜等数据。 媒体和娱乐 使用KVS存储媒体元数据、用户数据、数字权限管理等信息。 软件和互联网
表简介 表是用来存储键值数据（Key-Value，简称KV）的集合，归属于某个仓。 用户可以在一个仓中创建至少1个或多个表，用来储存键值数据。例如，用某个仓记录公司内所有员工的信息，那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。 图1 表简介 KVS云服务支持创建表，查询所有表及详细信息。
查询索引 操作场景 本章节指导用户在指定表中查询索引。 前提条件 已成功创建要查询的索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”，进入存储仓列表。 在仓列表中单击需要查询索引的表所在仓的名称。 在表列表中单击需要查询索引的表的名称，进入表详情页面。
步骤七：插入KV数据 操作场景 键值数据（Key-Value），简称KV，是文档型的数据项，提供主键到Value的映射。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来插入KV数据。 操作步骤 表1 不同访问方式插入KV数据的方法 访问方式 插入KV数据方法 控制台
步骤五：创建存储仓 操作场景 存储仓是用来存储表数据的单元，在创建表前需要先创建存储仓。KVS提供多种使用方式，您可以根据使用习惯、业务场景选择不同的方式来创建存储仓。 操作步骤 表1 不同访问方式创建存储仓的方法 访问方式 创建存储仓方法 控制台 通过控制台创建存储仓 SDK 通过SDK创建存储仓
调用说明 键值存储服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用，SDK的使用方法请参见SDK参考。 父主题： 使用前必读
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
