检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过控制台访问KVS,您首先要使用您的华为云账号或IAM用户登录控制台,在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。 而在使用其他方式访问KVS时,例如工具SDK或API,不需要您提供华为云账号或IAM用户登录信息,取而代之的是通过账号或IAM用户的访问密钥(AK/SK)来进行
产品功能 表1列出了KVS提供的主要功能特性。 表1 KVS功能概览 功能名称 功能描述 存储仓管理 存储仓是用来存储表数据的单元。用户可以根据自己的业务系统划分,创建不同的仓。支持创建、查询存储仓。 表管理 表是用来存储键值数据的集合,归属于某个仓。用户可以在一个仓中创建一个或
本章节指导用户删除指定KV。 前提条件 要删除的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要删除KV的仓,单击表名进入要删除KV的表。 选择“KV信息”页签。 找到要删除的KV,在右侧操作列,单击“删除”。 图1
和网络时延的要求。 如果您的应用需要较高的容灾能力,建议您将资源部署在同一区域的不同可用区内。 如果您的应用要求实例之间的网络延时较低,则建议您将资源创建在同一可用区内。 区域和终端节点 当您通过API使用资源时,您必须指定其区域终端节点。有关华为云的区域和终端节点的更多信息,请参阅地区和终端节点。
of strings 返回的表名列表。 长度:最大100 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 列举指定仓中的表,限制返回表数量为2 POST
Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
分区键和排序键之间的对比如表1所示 表1 分区键、排序键对比 对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。 表中的KV会根
参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 上传单个kv,表名为test-table-1,上传的kv为非结构化数据 POST https://{endpoint}/v1/put-kv
error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 更新单个kv,设置表名为test-table-1,设置更新的kv分区键值为user1,排序键为test-file-1,设置更新的鑫数据为非结构化数据。 POST ht
已成功创建要查询的索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 在仓列表中单击需要查询索引的表所在仓的名称。 在表列表中单击需要查询索引的表的名称,进入表详情页面。 单击“索引”页签,即可查看到当前表中已存在的所有索引信息。 图1
上传kv操作, "oper_id"数组。 数组元素:请求内的操作编码,未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码,未成功的操作返回该标识。 数组元素:请求内的操作编码,未成功的操作返回该标识。 请求示例 批量写请求,向test-table-1表中插入和删除一个kv
仓列表。 单击仓名进入要插入KV的仓,单击表名进入要插入KV的表。 选择“KV信息”页签。 单击左上角的“插入KV”。 填写必选属性的属性值,即KV分区键和排序键的值。 【可选】如果您除了分区键和排序键外,还需要新增其他属性,可以单击属性表单下方的“添加KV”,自定义属性和属性值。
前提条件 已成功创建要查询的表。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名称,进入仓详情页面。 在“表信息”下的搜索框中选择“属性类型 > 表名称”,或者输入关键字后单击“Enter”键,筛选出要查看的表。 图1 查询表 父主题:
存储仓限制 存储仓名称长度范围为16-52个字符,字母大小写不敏感,不能包含“.”,且名称全网唯一。 单个账号可以创建的存储仓数量不超过25个。 存储仓的备份不能用于单表的恢复。 存储仓与其内表不能同时开启PITR。 一个存储仓归属于1个主Region或多个从Region。 暂不支持删除存储仓。
xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于创建表接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于创建表接口,返回如图1所示的消息头。表创建
数据保护技术 KVS通过多种数据保护手段和特性,保障存储在KVS中的数据安全可靠。 表1 KVS数据保护手段和特性 数据保护手段 简要说明 传输加密(HTTPS) KVS的传输链路支持HTTPS加密传输,TLS加密套件优先使用高安全加密算法。 操作认证 所有KVS API都会进行身份认证。
本章节指导用户在指定仓中创建指定表的索引。 前提条件 已成功创建要指定索引的表。 约束与限制 一个表支持创建5个本地二级索引和20个全局二级索引。 仅支持在创建表的过程中创建索引。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 在仓列表中找到需要创建索引的表所在
已成功创建要插入KV的表。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要插入KV的仓,单击表名进入要插入KV的表。 选择“KV信息”页签。 单击左上角的“插入KV”。 图1 “插入KV”界面 填写必选属性的属性值,即KV分区键和排序键的值。
前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要更新KV的仓,单击表名进入要更新KV的表。 选择“KV信息”页签。 找到要更新的KV,在右侧操作列,单击“编辑”,进入KV属性表单。
查询单个kv 功能介绍 下载一个kv文档的全部内容,或者部分字段的内容。 URI POST /v1/get-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名,全域唯一,不同租户的仓名不能相同。 格式:${prefix}-${