向量查询

引擎索引重建成功后就可以开始搜索体验,向量检索版在控制台中内置了“查询测试”功能方便用户查询测试。支持向量查询、主键查询、向量文本混合查询三种查询方式,本文介绍向量查询。

界面入口

点击【查询测试】-【向量查询】,选择要查询的表名,支持表单模式开发者模式,右上方下拉框可切换,默认为表单模式

image

表单模式

查询参数用表单编辑,查询结果会展示到下方列表,部分查询功能不支持。

image

查询参数说明:

  1. 表名:必填,需要召回的表,下拉选实例中状态为使用中的表。

  2. 索引名称:必填,选择实例表之后,索引名会自动填入,无需用户再选择。

  3. TopK:必填,最大可返回的搜索结果条数,默认为10,支持填写大于0的整数。

  4. 过滤条件:非必填,支持的操作符有>、<、=、<=、>=、!=,多个条件之间支持AND、OR和()进行连接,可参考filter表达式语法。

  5. Query类型:必填,用于搜索的Query数据类型,如向量、图片或文本。

  6. 命名空间:非必填,通过命名空间对向量索引进行分区查询。

  7. 结果排列顺序:必填,可选择ASC(升序)和DESC(降序),默认为ASC。

  8. 文本向量值内容输入框:Query类型为向量时,输入向量值,格式为数组类型;Query类型为图片时,支持上传本地图片或base64编码;Query类型为文本时,输入文本内容。

Query类型为向量

表名选择后,索引名称会自动展示,无需用户选择,Query类型为向量类型,下方输入框会出现输入向量的维度提示:

image

输入对应的向量维度数据,点击【搜索】,下方会展示搜索结果列表,如图:

image

Query类型为图片

表名选择后,索引名称会自动展示,无需用户选择,Query类型为图片类型(仅限使用OpenSearch内置embedding能力的表使用),会出现图片类型选择,目前支持上传图片和base64编码两种方式,默认为base64编码,如图:

image

上传图片方式

image

点击上传图片选择本地图片,可选择多主体识别开启模式,点击【搜索】,效果展示如下:

image

说明

多主体识别结果说明

  1. 将识别的全部主体,框选并编号

  2. 默认展示像素最大主体的搜索结果,图片中会高亮主体范围

  3. 可手动点击主体序号,切换主体搜索,搜索结果和图片高亮位置对应变化。

重要

图片上传规则说明

  • 图片支持格式(png、jpg、jpeg)。

  • 图片大小不可超过2M。

base64编码方式

image

选择base64编码,需要输入对应的base64编码值,点击【搜索】,效果展示如下:

image

Query类型为文本

表名选择后,索引名称会自动展示,无需用户选择,Query类型为文本类型,下方输入框会出现输入文本内容提示,文本搜索仅限有embedding能力的表:

image

输入文本内容,点击【搜索】,下方会展示搜索结果列表,如图:

image

开发者模式

查询与结果均展示原始语句,支持全部查询功能。

image

在搜索框中输入查询相关参数,点击【搜索】,右边框内会展示搜索结果,如图:

image

单向量查询示例如下:

{
  "vector": [0.345263,0.346272,0.33663.....],
  "topK": 10,
  "indexName": "",
  "includeVector": true,
  "namespace":"test1"
}
  • vector:格式为list[float],将向量值内容输入进去即可,注意维度需要和引擎搭建维度一致。

  • topK:返回个数,可根据需求设置,默认为10。

  • indexName:非必填,向量索引名称。

  • includeVector:是否返回文档中的向量信息,默认为true,可以设置。

  • namespace:非必填,若实例配置有类目,则必须配置,否则可忽略。

多向量多namespace查询示例:

{
  "tableName": "gist",
  "indexName": "vec_index",
  "queries": [
    {
      "vector": [0.1, 0.2, 0.3],
      "namespace": "space_a"
    },
    {
      "vector": [0.4, 0.5, 0.6],
      "namespace": "space_b"
    }
  ]
  "topK": 3,
  "includeVector": true
}

更多参数可参考向量查询文档。

注意事项

表单模式查询限制:

  1. 不支持多namespace查询。

  2. 不支持同时查多个向量索引。

  3. 不支持查多个向量。

  4. 默认返回文档中的向量信息。

  5. 默认返回对应doc的所有字段信息+值。

  6. 默认对结果分数过滤。