检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过控制台访问KVS,您首先要使用您的华为云账号或IAM用户登录控制台,在这种场景下KVS通过您的账号或IAM用户信息进行鉴权。 而在使用其他方式访问KVS时,例如工具SDK或API,不需要您提供华为云账号或IAM用户登录信息,取而代之的是通过账号或IAM用户的访问密钥(AK/SK)来进行
在使用SDK访问KVS前,您需要提前获取和安装KVS SDK,并进行相关的配置和初始化。 操作步骤 表1 工具获取和初始化 工具 获取和安装方法 配置和初始化方法 SDK 参见SDK概述>参考文档的“SDK获取和安装”章节。 参见SDK概述>参考文档的“用户手册”。
步骤六:创建表(同时指定索引) 操作场景 表是用来存储键值数据的集合,在插入KV数据前需要先创建表。KVS提供多种使用方式,您可以根据使用习惯、业务场景选择不同的方式来创建表。 操作步骤 表1 不同访问方式创建表的方法 访问方式 创建表方法 控制台 通过控制台创建表 SDK 通过SDK创建表
本地二级索引和全局二级索引之间的对比如表1所示。 每个索引属于一个表,该表称为索引的主表。 表1 本地二级索引、全局二级索引对比 对比维度 本地二级索引 全局二级索引 概念 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。 表支持创建非主键字段的全局检索,
用户与Server之间的socket连接在超时时间内没有进行读写操作 检查网络后重试,或联系技术支持 409 Conflict KVS.00001018 StoreAlreadyExists 请求的Store名已经存在Store的命名空间是系统中所有用户共用的,选择一个不同的Store名再重试一次
支持KMS数据加密功能,消除在保护敏感数据时涉及的操作负担和复杂性。 弹性扩展无上限 用户表的数据规模可以无限扩展,访问流量可以自动扩展,且自动满足业务高峰低谷访问的弹性需求。 权限控制方式多 提供公网访问能力,对云内云外每个请求进行签名认证; 系统还会对用户进行运营权限检查。
仓列表。 单击仓名进入要插入KV的仓,单击表名进入要插入KV的表。 选择“KV信息”页签。 单击左上角的“插入KV”。 填写必选属性的属性值,即KV分区键和排序键的值。 【可选】如果您除了分区键和排序键外,还需要新增其他属性,可以单击属性表单下方的“添加KV”,自定义属性和属性值。
使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名,也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 父主题: 如何调用API
键值数据(Key-Value),简称KV,是文档型的数据项,提供主键到Value的映射。KV数据存储在表中。 分区键和排序键 分区键:分区键是一个表的属性,用于确定该表中的每一个KV存储所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。
前提条件 要更新的KV数据已存在。 约束与限制 分区键和排序键不支持更新修改。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要更新KV的仓,单击表名进入要更新KV的表。 选择“KV信息”页签。 找到要更新的KV,在右侧操作列,单击“编辑”,进入KV属性表单。
ational State Transfer)风格API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时键值存储服务还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 上传单个kv,表名为test-table-1。 POST https://{endpoint}/v1/put-kv { "table_name"
IAM身份认证 用户访问KVS的方式有多种,包括KVS控制台、API、SDK,无论访问方式封装成何种形式,其本质都是通过KVS提供的REST风格的API接口进行请求。 KVS的接口支持认证请求。经过认证的请求总是需要包含一个签名值,该签名值以请求者的访问密钥(AK/SK)作为加密
本章节指导用户删除指定KV。 前提条件 要删除的KV数据已存在。 操作步骤 登录KVS管理控制台。 在KVS管理控制台左侧导航栏选择“仓”,进入存储仓列表。 单击仓名进入要删除KV的仓,单击表名进入要删除KV的表。 选择“KV信息”页签。 找到要删除的KV,在右侧操作列,单击“删除”。 图1
附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息,从服务API的URL中获取。值为h
步骤五:创建存储仓 操作场景 存储仓是用来存储表数据的单元,在创建表前需要先创建存储仓。KVS提供多种使用方式,您可以根据使用习惯、业务场景选择不同的方式来创建存储仓。 操作步骤 表1 不同访问方式创建存储仓的方法 访问方式 创建存储仓方法 控制台 通过控制台创建存储仓 SDK 通过SDK创建存储仓
上传kv操作, "oper_id"数组。 数组元素:请求内的操作编码,未成功的操作返回该标识。 delete_kv_ids Array of integers 请求内的操作编码,未成功的操作返回该标识。 数组元素:请求内的操作编码,未成功的操作返回该标识。 请求示例 批量写请求,向test-table-1表中插入和删除一个kv
本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 约束与限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId,对于这些类型的KV,一条KV的key和value之和最大为512KB,包含主键和本地二级索引。 字段名称长
参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 删除单个kv,删除kv的分区键为user,排序键为test-file-1 POST https://{endpoint}/v1/delete-kv
键值数据(Key-Value),简称KV,是文档型的数据项,提供主键到Value的映射。KVS提供多种使用方式,您可以根据使用习惯、业务场景选择不同的方式来插入KV数据。 操作步骤 表1 不同访问方式插入KV数据的方法 访问方式 插入KV数据方法 控制台 通过控制台插入KV数据 SDK 通过SDK插入KV数据