ossutil query-vectors で類似ベクトルを取得 - OSS - Alibaba Cloud - Object Storage Service

query-vectors コマンドを使用して、ベクター類似検索を実行します。

権限

Alibaba Cloud アカウントには、デフォルトですべての権限があります。一方、RAM ユーザーと RAM ロールには権限がないため、アカウント所有者または管理者が RAM ポリシーまたはバケットポリシーを通じてアクセス権を付与する必要があります。

API	アクション	説明
QueryVectors	`oss:QueryVectors`	ベクターデータをクエリします。

コマンド形式

ossutil vectors-api query-vectors --bucket value --index-name value --query-vector value --top-k value  [flags]

パラメータ

パラメータ	型	説明
--bucket	string	ベクターバケットの名前。
--index-name	string	ベクターインデックスの名前。
--query-vector	string	JSON 形式のクエリベクター。クエリベクターのディメンションは、ベクターインデックスのディメンションと同じである必要があります。
--top-k	int	返す類似ベクトルの最大数。有効値：1～500。
--filter	string	メタデータを使用したクエリデータのフィルタリング条件。単一フィルターの最大長：20 KB フィルター命令の最大数：1,024
--return-distance	/	このパラメータを省略するか、`true` に設定すると、類似度距離が返されます。
--return-metadata	/	このパラメータを省略するか、`true` に設定すると、メタデータが返されます。

説明

query-vectors コマンドは、QueryVectors API に対応しています。
サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。

フィルター演算子

演算子	タイプ	説明
`$eq`	String	配列型のメタデータに使用する場合、この演算子は、値が配列内のいずれかの要素と一致する場合に `true` を返します。
`$ne`	String	指定された値と等しくない値に一致します。
`$gt`	Number	より大きい。
`$gte`	Number	以上。
`$lt`	Number	より小さい。
`$lte`	Number	以下。
`$in`	String 配列	配列内のいずれかの値に一致します (SQL の `IN` 演算子と同様)
`$nin`	String 配列	配列内のいずれの値とも一致しません (SQL の `NOT IN` 演算子と同様)。
`$exists`	Boolean	メタデータキーが存在するかどうかを確認します。
`$and`	空でないフィルターの配列	フィルター条件の配列に対して論理 AND 演算を実行します。
`$or`	空でないフィルターの配列	フィルター条件の配列に対して論理 OR 演算を実行します。

例

次のコマンドは、examplebucket ベクターバケットの index ベクターインデックスから、クエリベクターに最も類似し、かつ type が comedy または documentary である上位 10 件のベクトルを検索します。

ossutil vectors-api query-vectors --bucket examplebucket --index-name index --filter "{\"$and\":[{\"type\":{\"$in\":[\"comedy\",\"documentary\"]}}]}" --query-vector "{\"float32\":[32]}" --top-k 10