检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
插入KV 操作场景 本章节指导用户在指定仓、指定表中插入KV新数据。 前提条件 已成功创建要插入KV的表。 约束与限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引。
创建表 功能介绍 在指定仓内创建表，表名在仓内唯一；创建表时，指定主键模板及本地二级索引模板及全局二级索引模板。创建表时，如果仓不存在，将会自动创建仓。 URI POST /v1/create-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name
小于等于、不等于、前缀、包含于、不包含于和是否存在。其中包含于和不包含于条件支持输入或选择多个类型及相匹配的属性值。 类型 类型支持选择字符串、整型、长整型、浮点数、布尔值、日期、二进制、时间戳和ObjectId。 值 输入或选择与类型对应的属性值。 单击“运行”，符合扫描条件的KV将展示在KV信息列表中。
号（SSN）是分区键，姓名（Name）是排序键，这两者KV必须赋值。性别（Gender）、职位（Job）、获奖记录（Award Records）等属性是附加的可选属性，用户可以自定义。 Employee { "SSN": 0123456789, "Name": "张三"
查询表 功能介绍 指定仓查询表属性，如容量，规模，配额。 URI POST /v1/describe-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${
条件表达式，参见conditional小节，禁止携带主键字段。 长度：[8,4096] update_fields 否 update_fields object 对kv_doc有效。 表3 condition_expression 参数 是否必选 参数类型 描述 single_field_expression
上传单个kv 功能介绍 指定表，新建kv或覆盖已有kv，且满足表的key schema描述；允许指定条件执行。 URI POST /v1/put-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
无需购买计算资源且无需预置资源，完全托管，简单易用，为您节省运维成本，拥有云账号即可实现键值的存取。 存储结构灵活 支持BSON格式数据类型，原生数据格式无需字符串转换，数据处理更高效，且支持多数据类型字段自由组合。 数据读写效率高 支持本地二级索引和全局二级索引，提升检索效率； 支持前缀遍历，提升遍历效率。
返回的kv列表，与scan-kv接口的returned_kv_item字段相同。 表9 returned_kv_item 参数 参数类型 描述 kv_doc Document 对kv_doc有效。 请求示例 扫描分区键值等于user1的所有kv POST https://{endpoint}/v1/scan-skey-kv
列举表 功能介绍 指定仓列举创建的所有表。 URI POST /v1/list-table 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}-${region-code
=4，返回的段列表[MinKey, KV1)、[KV1,KV2)、[KV2,KV3)和[KV3,MaxKey)。用户可以使用scan-kv对这四个分区执行并发扫描，提高遍历效率。 范围: [1, 10000]。默认值：不执行采样。 sample_segments_count仅能和
删除单个kv 功能介绍 指定表，指定主键，删除该文档；允许指定条件执行。 URI POST /v1/delete-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。 格式：${prefix}
返回解析记录的权重比例。默认值为1，取值范围：0~1000。 标签 可选参数。 记录集的标识，包括键和值，每个记录集可以创建10个标签。 描述 可选参数。 对域名的描述。长度不超过255个字符。 单击“确定”，返回“解析记录”页面。添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集。当记
Document 用户自定义的主键名及值。 响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 kv_doc Document 对kv_doc有效。 说明： 内容字段：主键字段+投影字段或者全部字段。 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code
返回解析记录的权重比例。默认值为1，取值范围：0~1000。 标签 可选参数。 记录集的标识，包括键和值，每个记录集可以创建10个标签。 描述 可选参数。 对域名的描述。长度不超过255个字符。 单击“确定”，返回“解析记录”页面。添加完成后，您可以在域名对应的记录集列表中查看已添加的记录集。当记
单个存储仓下可以创建的表数量不超过100个。 一个主表仅支持创建1个分区键和1个排序键。 一个表一定归属于某个存储仓。 暂不支持删除表。 KV限制 KV类型包含字符串、布尔值、空值、浮点数、数组、映射、日期和ObjectId，对于这些类型的KV，一条KV的key和value之和最大为512KB，包含主键和本地二级索引。
批量写请求 功能介绍 批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。 URI POST /v1/batch-write-kv 表1 Query参数 参数 是否必选 参数类型 描述 store_name 否 String 仓名，全域唯一，不同租户的仓名不能相同。
该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/S
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
