检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
仓接口 列举仓 创建表 列举表 父主题: API
约束与限制 存储仓限制 存储仓名称长度范围为16-52个字符,字母大小写不敏感,不能包含“.”,且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。 表限制
SDK概述 本文介绍了KVS服务提供的SDK语言版本,列举了最新版本SDK的获取地址。 SDK列表 表1提供了KVS服务支持的SDK列表,您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java h
请求费用 通过控制台、API等任意方式对KVS进行操作,实际上都是对KVS API的调用,每调用一次API都计算一次读/写数据的大小。KVS会根据调用API的读/写数据的大小进行费用收取。 其中对于预置计费模式,当表读/写的每秒吞吐量超过预置值时,请求默认将被限流,费用按预置吞吐量计算。
存储费用 在使用键值存储服务时,按实际使用的存储容量和时长收费。具体计费说明如表1所示。 计费说明 表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据(所有KV和索引)所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时,HTTP请求返回一个3xx,4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。
概述 欢迎使用键值存储服务(Key-Value Storage Service, KVS)。键值存储服务提供完全托管的键值存储及索引服务,主要用于应用的键值类数据(如:元数据、描述数据、管理参数、状态数据)的存储,提供可预测的性能和无缝扩展,无需进行分区管理、硬件预置、集群扩展等操作。
创建表 操作场景 本章节指导用户在指定存储仓创建表,同时指定索引。 前提条件 已成功创建要创建表的存储仓。 约束与限制 单个存储仓下可以创建的表数量不超过100个。 一个表一定归属于某个存储仓。 表的名称长度范围为3-52个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”组成,且表的名称在存储仓内唯一。
查询表 操作场景 本章节指导用户在指定存储仓内查询表。 前提条件 已成功创建要查询的表。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名称,进入仓详情页面。 在“表信息”下的搜索框中选择“属性类型 > 表名称”,或者输入关键字
KV简介 键值数据(Key-Value),以下简称KV,是KVS云服务数据存储的最小单位,用来存储用户具体数据信息,是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据,仓中包含1个或多个表,表中包含0个或多个KV,每个KV都有不同于其他所有KV的唯一标识。例如,用一张
索引简介 索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。键值写入时,自动生成并存储本
删除索引 操作场景 本章节指导用户在创建表的过程中删除指定索引。 前提条件 在创建表的过程中,已指定索引且未完成表的创建。 约束与限制 目前仅支持在创建表的过程中删除索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 在仓列表中找到
表简介 表是用来存储键值数据(Key-Value,简称KV)的集合,归属于某个仓。 用户可以在一个仓中创建至少1个或多个表,用来储存键值数据。例如,用某个仓记录公司内所有员工的信息,那么可以用这个仓中的每一个表记录每一个部门内所有员工的信息。 图1 表简介 KVS云服务支持创建表,查询所有表及详细信息。
查询索引 操作场景 本章节指导用户在指定表中查询索引。 前提条件 已成功创建要查询的索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 在仓列表中单击需要查询索引的表所在仓的名称。 在表列表中单击需要查询索引的表的名称,进入表详情页面。
如何调用API 构造请求 认证鉴权 返回结果
创建索引 操作场景 本章节指导用户在指定仓中创建指定表的索引。 前提条件 已成功创建要指定索引的表。 约束与限制 一个表支持创建5个本地二级索引和20个全局二级索引。 仅支持在创建表的过程中创建索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。
数据保护技术 KVS通过多种数据保护手段和特性,保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密(HTTPS) KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。
步骤七:插入KV数据 操作场景 键值数据(Key-Value),简称KV,是文档型的数据项,提供主键到Value的映射。KVS提供多种使用方式,您可以根据使用习惯、业务场景选择不同的方式来插入KV数据。 操作步骤 表1 不同访问方式插入KV数据的方法 访问方式 插入KV数据方法 控制台
步骤五:创建存储仓 操作场景 存储仓是用来存储表数据的单元,在创建表前需要先创建存储仓。KVS提供多种使用方式,您可以根据使用习惯、业务场景选择不同的方式来创建存储仓。 操作步骤 表1 不同访问方式创建存储仓的方法 访问方式 创建存储仓方法 控制台 通过控制台创建存储仓 SDK 通过SDK创建存储仓
预置计费 预置计费是一种先使用再付费的计费模式,适用于无需任何预付款、长期承诺或希望控制成本的用户。 使用该模式,需要用户在创表时能够预估应用每秒读/写KVS的吞吐量,并设置到表中,当该表读/写的每秒吞吐量超过该预置值时,请求默认将被限流。 本文将介绍KVS预置计费资源的计费规则。