表單模式添加資料
添加向量資料
在向量管理>添加資料頁中選擇表進行添加資料:
表單模式僅支援添加單條資料。選擇表後頁面顯示欄位結構,例如欄位 id(主鍵,INT64)和欄位 float(稀密向量,FLOAT,多值),其中向量維度必須為128維,需填寫數組格式內容,如 [0.1, 0.2, 0.3]。
添加相應欄位值(包括主鍵、稠密向量),點擊添加。例如,id 填入 1,向量欄位填入128維浮點數數組,如 [0.1, 0.2, 0.3, ...]。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
在左側導覽列選擇向量管理 > 查詢測試,選擇向量查詢 Tab。設定表名為 test,TopK 為 10,Query類型為向量,結果排列順序為 ASC,在向量輸入框中填入待查詢的浮點數向量數組,單擊搜尋。查詢結果返回1條匹配資料,距離分為0,主鍵為1,查詢耗時5.93ms。
添加混合檢索資料
在向量管理>添加資料頁中選擇表進行添加資料:
選擇表 test_hybrid_search,切換為表單模式添加單條資料。稠密向量欄位維度須為128維,填寫數組格式內容,如 [0.1, 0.2, 0.3]。
添加相應欄位值(包括主鍵、稠密向量、稀疏向量下標、稀疏向量值),點擊添加:
選擇表單模式,表名選擇test_hybrid_search。樣本欄位值:id為1,vector為[0.03,0.15,0.91,0.17,...],sparse_indices為[1,2,3],sparse_values為[0.1,0.2,0.3],namespace為1。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
選擇向量文本混合查詢頁簽,設定表名(如 test_hybrid_search)、TopK(如 10)、過濾條件(如 price > 100)、索引名稱及結果排列順序,填寫稠密向量、稀疏向量下標(如 [1,2,3])和稀疏向量值(如 [0.1,0.2,0.3]),單擊搜尋即可查看混合檢索結果。
添加embedding的文本資料
在向量管理>添加資料頁中選擇表進行添加資料:
選擇表名 test_text_api,表中包含以下欄位:id(主鍵,INT64)、source_text_vector(稠密向量,FLOAT,由 OpenSearch 自動產生,無需填寫)、source_text(需 embedding 欄位,STRING)和 namespace(INT64)。
添加相應欄位值(包括主鍵、需要embedding 欄位),點擊添加:
選擇表名 test_text_api,填寫 id(主鍵)為 1,source_text(embedding欄位)為 opensearch向量檢索版。source_text_vector(稠密向量)由 OpenSearch 自動產生,無需填寫。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
在查詢測試頁面選擇向量查詢 Tab,將表名設定為 test_text_api,索引名稱設定為 source_text_vector,TopK設定為 10,Query類型選擇文本,在文本輸入框中輸入 向量檢索版,然後單擊搜尋。返回一條匹配結果,距離分為 0.389988780021675,主鍵為 1,屬性中 source_text 值為 openSearch向量檢索版,表明文本向量查詢成功。
添加embedding的圖片資料
在向量管理>添加資料頁中選擇表進行添加資料:
選擇表單模式(僅支援添加單條資料),表名選擇目標表。欄位列表中,source_image_vector(稠密向量)欄位由 OpenSearch 自動產生,無需填寫。
添加相應欄位值(包括主鍵、需embedding 欄位,圖片欄位可以通過上傳圖片和填寫base64編碼的方式上傳),點擊添加:
樣本中選擇表名 test_create,填寫欄位:id(主鍵)值為 1,source_image_vector(稠密向量)由 OpenSearch 自動產生,source_image(需 embedding 欄位)通過上傳圖片方式上傳檔案,namespace 值為 1。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
將Query類型設定為圖片,結果排列順序設定為ASC,圖片提供方式選擇上傳圖片檔案,多主體識別選擇不開啟,上傳待搜尋的圖片後單擊搜尋。搜尋結果將展示匹配記錄的距離分、主鍵、向量值及屬性列等資訊。
開發人員模式添加資料
添加向量資料
在向量管理>添加資料頁中選擇表進行添加資料:
頁面預設為表單模式(僅支援添加單條資料),選擇表名後展示欄位列表,包含欄位名稱、欄位標籤(如主鍵、精密向量)、資料類型等列,向量欄位輸入框會提示所需維度及數組格式(如 [0.1, 0.2, 0.3])。填寫完成後單擊添加提交資料。
右上方選擇開發人員模式,添加相應欄位值(包括主鍵、向量欄位),點擊添加:
樣本JSON資料格式為 [{"id": 0, "float": [0.03, 0.15, 0.91, 0.17, ...]}],其中 id 為主鍵欄位,float 為浮點數數組形式的向量欄位。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
在查詢測試頁面選擇向量查詢頁簽,設定表名、索引名稱及TopK,在向量輸入框中填寫查詢向量(浮點數數組格式),單擊搜尋即可查看檢索結果,包括距離分、主鍵及向量值等資訊。
添加混合檢索資料
在向量管理>添加資料頁中選擇表進行添加資料:
選擇表名 test_hybrid_search,頁面預設為表單模式,展示 id(主鍵)、vector(稠密向量)、sparse_indices(稀疏向量下標)、sparse_values(稀疏向量值)、namespace 共 5 個欄位。
右上方選擇開發人員模式,添加相應欄位值(包括主鍵、稠密向量、稀疏向量下標、稀疏向量值),點擊添加:
JSON欄位名與前述欄位的對應關係為:id(主鍵)、vector(稠密向量)、sparse_indices(稀疏向量下標)、sparse_values(稀疏向量值),另包含 namespace 欄位。資料以JSON數組格式提交,每個元素為一條記錄。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
選擇向量文本混合查詢頁簽,在表名下拉框中選擇目標表(例如 test_hybrid_search),設定TopK(例如 10)、索引名稱(例如 vector)、結果排列順序(例如 DESC),填入稠密向量、稀疏向量下標(例如 [1,2,3])和稀疏向量值(例如 [0.1,0.2,0.3]),單擊搜尋按鈕。搜尋結果將以表格形式展示距離分、主鍵、稠密向量值、稀疏向量下標、稀疏向量值、屬性和命名空間等資訊。
添加embedding的文本資料
在向量管理>添加資料頁中選擇表進行添加資料:
選擇表名 test_text_api,頁面預設為表單模式(僅支援添加單條資料),展示欄位列表包括 id(主鍵)、source_text_vector(稠密向量,由 OpenSearch 自動產生無需填寫)、source_text(需 embedding 欄位)和 namespace。
右上方選擇開發人員模式,添加相應欄位值(包括主鍵、需要embedding 欄位),點擊添加:
樣本 JSON 資料為 [{"id": 1, "source_text": "opensearch向量檢索版", "namespace": 1}],其中 id 為主鍵,source_text 為需要 embedding 的文字欄位,namespace 為命名空間。表名選擇 test_text_api。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
在查詢測試頁面選擇向量查詢頁簽,設定表名為test_text_api,索引名稱為source_text_vector,TopK為10,Query類型為文本,結果排列順序為ASC,在文本輸入框中輸入查詢文本(例如向量檢索版),單擊搜尋。查詢結果返回1條匹配記錄,距離分為0.389988780021675,主鍵為1,屬性中source_text值為openSearch向量檢索版。
添加embedding的圖片資料
在向量管理>添加資料頁中選擇表進行添加資料:
表單模式下選擇 test_create 表,欄位包括 id(主鍵,INT64)、source_image_vector(稠密向量,由 OpenSearch 自動產生無需填寫)、source_image(需 embedding 欄位,可通過上傳圖片或填寫base64編碼方式錄入)和 namespace(INT64)。填寫完成後單擊添加。
右上方選擇開發人員模式,添加相應欄位值(包括主鍵、需embedding 欄位,圖片欄位可以通過填寫base64編碼的方式上傳),點擊添加:
資料以JSON數組格式提交,每條記錄包含id(主鍵)、source_image(base64編碼的圖片字串)、namespace等欄位,表名選擇目標表(如test_create)。
當執行結果出現"message": "success" 說明資料上傳成功。
資料上傳成功後,可以在查詢測試頁面進行查詢:
設定Query類型為圖片,結果排列順序為ASC,圖片提供方式為上傳圖片檔案,上傳待檢索的圖片後單擊搜尋。搜尋結果以表格形式展示匹配記錄,包含距離分、主鍵、向量值、屬性、命名空間等欄位,距離分越小表示匹配度越高。
注意事項
-
插入資料單條記錄大小不允許超過1M
-
添加embedding的圖片資料,圖片大小允許超過1M
-
添加embedding的文本資料,文字大小不允許超過1K