get-vectors

通过get-vectors命令获取指定的向量数据。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM PolicyBucket Policy授予操作权限。

API

Action

说明

GetVectors

oss:GetVectors

获取向量数据。

命令格式

ossutil vectors-api get-vectors --bucket value --index-name value --keys value [flags]

参数说明

参数

类型

说明

--bucket

string

向量Bucket名称。

--index-name

string

索引名称。

--keys

strings

要查询的向量的主键,允许出现重复主键。限制:

  • 去重key数量 ∈ [1, 100]

  • key长度 ∈ [1, 1024]

--return-data

/

是否返回向量数据,留空或设置为 true 均表示开启。

--return-metadata

/

是否返回元数据,留空或设置为 true 均表示开启。

说明

使用示例

  • 获取名为 examplebucket 的向量Bucket中索引名为index,主键为keykey1的向量属性。

    ossutil vectors-api get-vectors --bucket examplebucket --index-name index --keys key,key1
  • 获取名为 examplebucket 的向量Bucket索引名为index,主键为keykey1,且指定返回向量数据的向量属性。

    ossutil vectors-api get-vectors --bucket examplebucket --index-name index --keys key,key1 --return-data
  • 获取名为 examplebucket 的向量Bucket中索引名为index,主键为keykey1,且指定返回元数据的向量属性。

    ossutil vectors-api get-vectors --bucket examplebucket --index-name index --keys key,key1 --return-metadata
  • 获取名为 examplebucket 的向量Bucket中索引名字index,主键为keykey1,且指定返回向量数据和元数据。

    ossutil vectors-api get-vectors --bucket examplebucket --index-name index --keys key,key1 --return-data--return-metadata