检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 更新单个kv,设置表名为test-table-1,设置更新的kv分区键值为user1,排序键为test-file-1,设置更新的鑫数据为非结构化数据。 POST https://{endpoint}/v1/update-kv
图2 “创建本地二级索引”界面 表2 “创建本地二级索引”参数说明 类别 参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。
本地二级索引与全局二级索引有什么区别? 本地二级索引和全局二级索引之间的对比如表1所示。 每个索引属于一个表,该表称为索引的主表。 表1 本地二级索引、全局二级索引对比 对比维度 本地二级索引 全局二级索引 概念 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。
图3 “创建本地二级索引”界面 表3 “创建本地二级索引”参数说明 类别 参数名称 描述 创建本地二级索引 名称 必选参数。 本地二级索引的名称。名称的长度范围为1-255个字符,由数字0-9、字符a-z、A-Z,及特殊符“-”、“_”、“.”组成。名称不支持设置为“XPriIndex”。
String 请求返回的错误码。 error_msg String 请求返回的错误信息。 请求示例 下载一个kv,表名为test-table-1,设置分区键值为user1,排序键值为test-file-1。 POST https://{endpoint}/v1/get-kv { "table_name"
准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。 本地二级索引 对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。键值写入时,自动生成并存储本地二级索引记录,并保证键值与本地二级索引记录的强一致。 全局二级索引
VS资源。 KVS目前仅支持在创建表的过程中删除全局二级索引或本地二级索引,所以仅支持停止与KV相关的计费。 针对KV资源的消费使用,支持通过账单查找KVS资源并停止相关计费。 通过账单查找KVS资源并停止计费 登录管理控制台,在顶部菜单栏中选择“费用 > 费用账单”,进入账单概览页面。
表1 存储费用说明 资费项 计费项 含义 适用的计费模式 存储费用 标准型容量 KVS中存储数据(所有KV和索引)所占用的存储空间容量。 存储时间按照数据在KVS中存储的实际每小时计算。 按需计费 计费示例 以下示例中出现的费用价格仅供参考。 假设某用户有一张exampletable
索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。 本地二级索引:对于复合主键(分区键+排序键)的表,支持创建本地二级索引,实现分区键下的多个键值的辅助索引。键值写入时,自动生成并存储本地二级索引记录,并保证键值与本地二级索引记录的强一致。 全局二级索引:表支
创建表 功能介绍 在指定仓内创建表,表名在仓内唯一;创建表时,指定主键模板及本地二级索引模板及全局二级索引模板。创建表时,如果仓不存在,将会自动创建仓。 URI POST /v1/create-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name
不建议您使用作为字段名。 对于主键,包含所有的本地二级索引,总长不超过1024个字节,且主键必须唯一。 使用API请求方式访问的KV,只能属于一个存储仓。 一个KV一定归属于某个表。 仓+表+Key可以唯一定位KV。 索引限制 本地二级索引必须以表分区键作为前缀。 全局二级索引KV写后延迟约3秒内可见。
储在表中。支持插入、更新、删除、查询KV数据。 索引管理 索引是用来辅助查询表中的KV数据,能够加速键值检索,准确访问键值数据。KVS提供本地二级索引和全局二级索引。支持创建、查询、删除索引。
从控制台获取项目ID 调用API获取项目ID 获取项目ID请参考:查询指定条件下的项目列表。 从控制台获取项目ID 从控制台获取项目ID的步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中的“我的凭证”。 在“API凭证”页面的项目列表中查看项目ID。 图1 查看项目ID
那么,该用户在8:00:00~10:00:00之间需要支付多少请求费用?请求费用构成及计费过程如下表所示: 表2 请求费用构成及计费过程 时间 用户操作 涉及计费项 单价 计费量 费用 8:00:00~9:00:00 查询请求 标准型读取请求 2.10元/百万RRU 1百万WRU
基于此案例,可详细计算出该用户的消费情况。 创建存储仓、创建表等操作不产生费用。 以下示例中出现的费用价格仅供参考。 表1 费用构成及计费过程 时间 用户操作 涉及计费项 单价 计费量 费用 8:00:00~9:00:00 创建存储仓 / / / 0元 创建表 / / / 0元 存储数据
存储结构灵活 支持BSON格式数据类型,原生数据格式无需字符串转换,数据处理更高效,且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引,提升检索效率; 支持前缀遍历,提升遍历效率。 数据高可用 提供区域内多可用区的同步读写,任一可用区故障均不影响业务;
API同时支持使用AK/SK认证,AK/SK认证使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 请求消息体(可选) 该部分可选。请求消息体通常以Bson格式发出
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下: 登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题: 附录
步骤四:下载SDK并初始化 操作场景 在使用SDK访问KVS前,您需要提前获取和安装KVS SDK,并进行相关的配置和初始化。 操作步骤 表1 工具获取和初始化 工具 获取和安装方法 配置和初始化方法 SDK 参见SDK概述>参考文档的“SDK获取和安装”章节。 参见SDK概述>参考文档的“用户手册”。
最多1个,必须指定主键schema。 local_secondary_index_schema Array of secondary_index objects 本地二级索引模板,可以多个。 global_secondary_index_schema Array of global_secondary_index