全部產品
Search
文件中心

OpenSearch:向量查詢

更新時間:Apr 11, 2025

引擎索引重建成功後就可以開始搜尋體驗,向量檢索版在控制台中內建了“查詢測試”功能方便使用者查詢測試。支援向量查詢、主鍵查詢、向量文本混合查詢三種查詢方式,本文介紹向量查詢。

介面入口

點擊【查詢測試】-【向量查詢】,選擇要查詢的表名,支援表單模式開發人員模式,右上方下拉框可切換,預設為表單模式

image

表單模式

查詢參數用表單編輯,查詢結果會展示到下方列表,部分查詢功能不支援。

image

查詢參數說明:

  1. 表名:必填,需要召回的表,下拉選執行個體中狀態為使用中的表。

  2. 索引名稱:必填,選擇執行個體表之後,索引名會自動填入,無需使用者再選擇。

  3. TopK:必填,最大可返回的搜尋結果條數,預設為10,支援填寫大於0的整數。

  4. 過濾條件:非必填,支援的操作符有>、<、=、<=、>=、!=,多個條件之間支援AND、OR和()進行串連,可參考filter運算式文法。

  5. Query類型:必填,用於搜尋的Query資料類型,如向量、圖片或文本。

  6. 命名空間:非必填,通過命名空間對向量索引進行分區查詢。

  7. 結果排列順序:必填,可選擇ASC(升序)和DESC(降序),預設為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. 預設對結果分數過濾。