使用准备

一、获取您的访问凭证（AK/SK）信息

AccessKey 与 SecretKey（AK/SK）是您访问向量存储（ZOS Vectors）的密钥，您使用 SDK 方式使用 ZOS Vectors 时，服务端会通过它来验证您的资源请求身份。

ZOS Vectors 目前有天翼云访问密钥（AK/SK）和 ZOS访问密钥（AK/SK）两种，已接入统一身份认证（Identity and Access Management，简称 IAM）服务的资源池使用天翼云访问密钥（AK/SK）即可。

说明

若不清楚如何正确获取您的访问凭证（AK/SK）信息，请阅读文档：获取访问密钥（AK/SK）。

ZOS Vectors 为每个地域（Region）提供单独的终端节点，终端节点可以理解为 ZOS Vectors 在不同地域的域名，用于处理各自地域的访问请求。使用 SDK 来访问 ZOS Vectors 资源，需要提前获取创建桶时所选地域的终端节点（Endpoint）信息。

注意

为您提供 ZOS Vectors（即CStor Vector）以下主流语言的开发指南和 SDK 安装包：

开发语言	开发指南	SDK 安装包下载
GO	ZOSVectors-go_SDK说明文档.pdf	ZOSVectors-sdk-golang(wr9y)
Python	ZOSVectors-python_SDK说明文档.pdf	ZOSVectors-sdk-python.zip

使用 QueryVectors 执行向量相似性搜索时，支持的元数据过滤表达式如下所示。

操作符	有效输入类型	过滤描述	示例
$eq	String, Number, Boolean	精确匹配单个值	{"genre": "documentary"} （隐式） {"genre": {"$eq": "documentary"}} （显式）
$ne	String, Number, Boolean	不等于匹配	{"genre": {"$ne": "drama"}}
$gt	Number	大于	{"year": {"$gt": 2019}}
$gte	Number	大于等于	{"year": {"$gte": 2020}}
$lt	Number	小于	{"year": {"$lt": 2020}}
$lte	Number	小于等于	{"year": {"$lte": 2020}}
$in	非空基本类型数组	在数组中	{"genre": {"$in": ["comedy", "documentary"]}}
$nin	非空基本类型数组	不在数组中	{"genre": {"$nin": ["comedy", "documentary"]}}
$exists: true	Boolean	元数据键存在	{"genre": {"$exists": true}}
$exists: false	Boolean	元数据键不存在	{"genre": {"$exists": false}}
$and	非空过滤器数组	多个条件同时满足	{"$and": [{"genre": {"$eq": "drama"}}, {"year": {"$gte": 2020}}]}
$or	非空过滤器数组	多个条件至少满足一个	{"$or": [{"genre": {"$eq": "drama"}}, {"year": {"$gte": 2020}}]}
$gt, $gte, $lt, $lte, $ne	Number	数值范围（同一字段有多个条件）	{"price": {"$gte": 10, "$lte": 50}}