通过list-vectors命令列举索引中的所有向量数据。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
ListVectors |
| 列举向量数据。 |
命令格式
ossutil vectors-api list-vectors --bucket value --index-name value [flags]
参数说明
参数 | 类型 | 说明 |
--bucket | string | 向量Bucket名称。 |
--index-name | string | 索引名称。 |
--max-results | int | 每次返回的最大结果数,默认值500。
|
--next-token | string | 查询凭证(Token),取值为上一次命令返回的nextToken参数值。参数长度为1~512字节。 |
--return-data | / | 是否返回向量数据,留空或设置为 |
--return-metadata | / | 是否返回元数据,留空或设置为 |
--segment-count | int | 并行度,最大为16。串行时,设置为1。 |
--segment-index | int | 分段的index,必须小于segment-count。 |
get-vectors命令对应API接口GetVectors。
关于支持的全局命令行选项,请参见全局命令行选项。
使用示例
列举名为 examplebucket 的向量Bucket中索引名为index下的所有向量。
ossutil vectors-api list-vectors --bucket examplebucket --index-name index
列举名为 examplebucket 的向量Bucket中索引名为index下的前100个向量。
ossutil vectors-api list-vectors --bucket examplebucket --index-name index --max-results 100
列举名为 examplebucket 的向量Bucket中索引名为index且从指定token开始的向量。
ossutil vectors-api list-vectors --bucket examplebucket --index-name index --next-token example
列举名为 examplebucket 的向量Bucket中索引名为index下的所有向量,最大默认返回500个。
ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-data
列举名为 examplebucket 的向量Bucket中索引名为index下的所有向量,且返回向量元数据。
ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-metadata