华为云首页用户手册

键值存储服务 KVS-扫描分区键内kv:请求参数

键值存储服务 KVS-扫描分区键内kv:请求参数

时间：2024-12-09 15:46:54

键值存储服务 KVS

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
table_name	是	String	表名，仓内唯一。长度：[3, 63] 取值字符限制：[a-z0-9_-]+
hint_index_name	否	String	create_table时指定的索引名。
limit	否	Long	返回的文档个数，最大100个。说明：默认100个文档。
shard_key	是	Document	要遍历的指定分区键下的kv。
start_sort_key	否	Document	起始排序键值，默认空表示从头遍历，左闭。说明：分页返回时，该值使用上次响应返回的cursor_sort_key
end_sort_key	否	Document	终止主键或索引键值，默认空表示直到最后，右开。
filter_expression	否	condition_expression object	过滤表达式。说明：允许主键字段作为条件。在满足shard_key和start_sort_key和end_sortkey的范围内，执行filter逻辑。

表3 condition_expression
参数	是否必选	参数类型	描述
single_field_expression	否	single_field_expression object	单字段条件。
multi_field_expression	否	multi_field_expression object	多字段条件，多个相同优先级的单字段条件。
composed_expression	否	composed_expression object	组合条件, 逐层同级的子表达式嵌套。

表4 multi_field_expression
参数	是否必选	参数类型	描述
logic	否	String	多字段条件，多个相同优先级的单字段条件。
expressions	是	Array of single_field_expression objects	多个相同逻辑操作的单字段条件。

表5 single_field_expression
参数	是否必选	参数类型	描述
field	是	String	条件字段。
func	是	String	条件函数，取值如"$gt", $lt","$gte", $lte" "$eq", "$ne", "$prefix", "$exists"。
value	否	Document	value和value_array二选一。 value条件值，适用于除"$in", "$nin"外的func。字段名无意义，可以传空，也可以传字段名。 $exists值为true/false。说明： $prefix操作只适用于string和binary类型。
value_array	否	Array of strings	"value"和"value_array"二选一。 "value_array" 条件值列表, 值用于"$in", "$nin"。

表6 composed_expression
参数	是否必选	参数类型	描述
logic	否	String	逻辑关系，取值如"$and", "$or", "$nor"。
expressions	是	Array of expression objects	多个相同优先级且相同逻辑的单字段或多字段条件。

表7 expression
参数	是否必选	参数类型	描述
single_field_expression	否	single_field_expression object	单字段条件。
multi_field_expression	否	single_field_expression object	多字段条件，多个相同优先级的单字段条件。
composed_expression	否	composed_expression object	组合条件, 逐层同级的子表达式嵌套。

上一篇：键值存储服务 KVS-扫描分区键内kv:URI

下一篇：键值存储服务 KVS-扫描分区键内kv:URI

新客秒杀 2核2G 3M L实例

68元/年

普惠上云领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元随心购

1元/年起

键值存储服务 KVS-扫描分区键内kv:请求参数

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题