检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
returned_kv_item objects 返回的kv列表。 表9 returned_kv_item 参数 参数类型 描述 kv_doc Document 对kv_doc有效。 请求示例 扫描所有kv,扫描条件为分区键的值为user2 POST https://{endpoint}/v1/scan-kv
hint_index_name 否 String create_table时指定的索引名。 limit 否 Integer 返回的文档个数,最大100个。 说明: 默认100个文档。 shard_key 是 Document 要遍历的指定分区键下的kv。 start_sort_key 否 Document
列举表 指定存储仓列举创建的所有表。 表接口 查询表 指定存储仓查询表属性,如容量,规模,配额。 KV接口 上传单个kv 指定表,新建kv或覆盖已有kv,且满足表的key schema描述;允许指定条件执行。 查询单个kv 下载一个kv文档的全部内容,或者部分字段的内容。 更新单个kv
用户调用了1次get-kv接口,查询的KV大小为8KB,那么此次计费的标准型读取请求单位数换算过程如下所示: 标准型读取请求单位数:8KB÷4KB=2RRU 结算标准型写入请求费用时,API调用KV的大小不足1KB的,按1KB计算;结算标准型读取请求费用时,API调用KV的大小不足4KB的,按4KB计算。
KVS API的调用,每调用一次API都计算一次请求大小。KVS会根据调用API的请求大小进行费用收取。 请求类别 KVS的请求分为两大类:标准型写入请求(将数据写入表)、标准型读取请求(从表读取数据)。 计费说明 表1 请求费用说明 资费项 计费项 含义 适用的计费模式 请求费用
KV接口 上传单个kv 查询单个kv 更新单个kv 删除单个kv 扫描所有kv 扫描分区键内kv 批量写请求 父主题: API
xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于创建表接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 对于创建表接口,返回如图1所示的消息头。表创建
索引简介 索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。键值写入时,自动生成并存储本
String 请求返回的错误码。 error_msg String 请求返回的错误信息。 状态码: 409 表17 响应Body参数 参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 创
String 仓名,全域唯一,不同租户的仓名不能相同。 格式:${prefix}-${region-code}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+
参数 参数类型 描述 error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 上传单个kv,表名为test-table-1,上传的kv为非结构化数据 POST https://{endpoint}/v1/put-kv
String 仓名,全域唯一,不同租户的仓名不能相同。 格式:${prefix}-${region-code}-${account-id},其中prefix为自定义前缀,region-code为kvs集群所在的区域代码,account-id为用户的账户id 取值字符限制:[a-z0-9-]+
error_code String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 更新单个kv,设置表名为test-table-1,设置更新的kv分区键值为user1,排序键为test-file-1,设置更新的鑫数据为非结构化数据。 POST ht
华为云:负责云服务自身的安全,提供安全的云。华为云的安全责任在于保障其所提供的 IaaS、PaaS 和 SaaS 类云服务自身的安全,涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身,也包括
单个存储仓下可以创建的表数量不超过100个。 一个表一定归属于某个存储仓。 暂不支持删除表。 KV限制 对于文档类型的KV,包含所有的本地二级索引,key和value之和最大为512KB。 字段名称长度范围为1-63个字节,大小写敏感,不支持“.”和“$”。“X”字符为前缀的字段名称为系
键值数据(Key-Value),简称KV,是文档型的数据项,提供主键到Value的映射。KV数据存储在表中。 分区键和排序键 分区键:分区键是一个表的属性,用于确定该表中的每一个KV存储所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。
分区键和排序键之间的对比如表1所示 表1 分区键、排序键对比 对比维度 分区键 排序键 应用场景 分区键用于确定该表中的每一个KV所在的分区。例如,对于一个用户表,可以指定用户名属性作为分区键。 KVS会根据此用户名的名称(KV)选择分区,同样的用户名名称存储在同一个分区。 表中的KV会根
数据存储的最小单位,用来存储用户具体数据信息,是文档型的数据项。KVS自顶向下按照仓、表、KV的结构存储数据,仓中包含1个或多个表,表中包含0个或多个KV,每个KV都有不同于其他所有KV的唯一标识。例如,用一张表记录某个部门所有员工的信息,每一个KV就代表一个员工,员工的身份证号就是唯一标识。
附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息,从服务API的URL中获取。值为h
本地二级索引和全局二级索引之间的对比如表1所示。 每个索引属于一个表,该表称为索引的主表。 表1 本地二级索引、全局二级索引对比 对比维度 本地二级索引 全局二级索引 概念 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。 表支持创建非主键字段的全局检索,