全部產品
Search
文件中心

OpenSearch:添加資料

更新時間:Jun 12, 2026

表單模式添加資料

添加向量資料

在向量管理>添加資料頁中選擇表進行添加資料:

表單模式僅支援添加單條資料。選擇表後頁面顯示欄位結構,例如欄位 id(主鍵,INT64)和欄位 float(稀密向量,FLOAT,多值),其中向量維度必須為128維,需填寫數組格式內容,如 [0.1, 0.2, 0.3]

添加相應欄位值(包括主鍵、稠密向量),點擊添加。例如,id 填入 1,向量欄位填入128維浮點數數組,如 [0.1, 0.2, 0.3, ...]

當執行結果出現"message": "success" 說明資料上傳成功。

資料上傳成功後,可以在查詢測試頁面進行查詢:

在左側導覽列選擇向量管理 > 查詢測試,選擇向量查詢 Tab。設定表名testTopK10Query類型向量結果排列順序ASC,在向量輸入框中填入待查詢的浮點數向量數組,單擊搜尋。查詢結果返回1條匹配資料,距離分為0,主鍵為1,查詢耗時5.93ms。

添加混合檢索資料

在向量管理>添加資料頁中選擇表進行添加資料:

選擇表 test_hybrid_search,切換為表單模式添加單條資料。稠密向量欄位維度須為128維,填寫數組格式內容,如 [0.1, 0.2, 0.3]

添加相應欄位值(包括主鍵、稠密向量、稀疏向量下標、稀疏向量值),點擊添加

選擇表單模式,表名選擇test_hybrid_search。樣本欄位值:id1vector[0.03,0.15,0.91,0.17,...]sparse_indices[1,2,3]sparse_values[0.1,0.2,0.3]namespace1

當執行結果出現"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(主鍵)為 1source_text(embedding欄位)為 opensearch向量檢索版source_text_vector(稠密向量)由 OpenSearch 自動產生,無需填寫。

當執行結果出現"message": "success" 說明資料上傳成功。

資料上傳成功後,可以在查詢測試頁面進行查詢:

查詢測試頁面選擇向量查詢 Tab,將表名設定為 test_text_api索引名稱設定為 source_text_vectorTopK設定為 10Query類型選擇文本,在文本輸入框中輸入 向量檢索版,然後單擊搜尋。返回一條匹配結果,距離分為 0.389988780021675,主鍵為 1,屬性中 source_text 值為 openSearch向量檢索版,表明文本向量查詢成功。

添加embedding的圖片資料

在向量管理>添加資料頁中選擇表進行添加資料:

選擇表單模式(僅支援添加單條資料),表名選擇目標表。欄位列表中,source_image_vector(稠密向量)欄位由 OpenSearch 自動產生,無需填寫。

添加相應欄位值(包括主鍵、需embedding 欄位,圖片欄位可以通過上傳圖片和填寫base64編碼的方式上傳),點擊添加

樣本中選擇表名 test_create,填寫欄位:id(主鍵)值為 1source_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_vectorTopK10Query類型文本結果排列順序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