前置條件
-
建立及使用應用依賴access key參數,主帳號下access key參數不可為空。
-
在為主帳號建立access key參數後,還可以再建立RAM子帳號access key通過RAM子帳號進行訪問,RAM子帳號賦予對應的存取權限,請參考RAM鑒權。
-
需要使用者擁有VPC環境,詳情可什麼是Virtual Private Cloud進行查看。
說明:
如果需要使用子帳號操作召回引擎版執行個體,請使用主帳號為子帳號授予AliyunSearchEngineFullAccess和AliyunSearchEngineReadOnlyAccess 許可權
購買執行個體
執行個體購買可參考:購買OpenSearch召回引擎版執行個體
配置叢集
說明:
新購買的執行個體,在其詳情頁中,執行個體狀態為“待配置”,並且會自動部署一個與購買的查詢節點和資料節點的個數及規格一致的空叢集。
1、選擇需要配置的執行個體,點擊配置。
2、按要求提填寫表名稱,選擇分區數,資料更新資源數,然後點擊下一步。
名稱:由字母、數字或底線組成,最大25字元。
分區數:請填寫不超過256的正整數, 用於提升全量構建速度、單次查詢效能。
資料更新資源數:即時資料更新資源數,調整資源可以擴大消費即時資料的並發數,從而提高TPS。
3、配置資料來源(目前支援的資料來源有“MaxCompute + API 資料來源”、“OSS + API 資料來源”、“API 資料來源”、資料湖構建(DLF)),本文以MaxCompute資料來源為例,配置完參數可按需選擇是否開啟“自動索引重建”,校正通過後,點擊下一步。
配置 MaxCompute 資料來源時需填寫以下參數:AccessKey 和 AccessKey Secret、專案名(Project)(以字母開頭,僅包含字母、數字和底線,長度 3~28 位)、表名(Table)(以字母開頭,僅包含字母、數字和底線,長度 1~128 位)、表資料分區(Partition)(多級分區間使用逗號分隔)。填寫完成後單擊 校正 按鈕通過資料來源校正,方可單擊 下一步。
4、勾選主鍵、屬性欄位、搜尋結果展示欄位、選擇資料是否壓縮和對應的欄位對應的分析方式
屬性和欄位內容壓縮:
-
屬性欄位可以選擇是否壓縮,預設為不壓縮,選擇file_compressor表示開啟壓縮
-
欄位內容可以選擇是否壓縮,預設為不壓縮,預設多值和STRING類型選擇uniq,單值數實值型別是equal
-
如果開啟了屬性壓縮,建議前往「叢集管理-節點狀態-表載入策略」編輯索引載入方式,以此降低對效能的影響。
-
配置分析方式的欄位類型必須為TEXT類型。
-
支援複製欄位操作,複製出的新欄位(DUP欄位)與原欄位內容保持一致(推送不一致內容時,將採用原欄位內容覆蓋),如期望欄位內容不一致,請手動刪除DUP欄位進階配置中的copy from配置
-
當資料中缺少欄位或欄位為空白時,系統將自動補充預設值,數字類型預設補0,STRING類型預設補Null 字元串,支援自訂預設值
5、給需要進行索引檢索的欄位配置對應的索引,配置完成後點擊下一步。
5、配置索引:在索引設定頁面,設定索引名稱、索引類型(如 TEXT、STRING)、包含欄位及資料壓縮方式,可單擊查看/修改調整進階配置,單擊 + 新增索引行,完成後單擊下一步。
6、點擊確認建立,等待版本構建完成。
確認資訊無誤後,單擊 確認建立。系統將自動基於選定的並發資源進行索引構建,構建完成後的索引將自動在當前執行個體中啟用。
查看索引重建進度
點擊左側導覽列變更歷史選擇近3天可查看具體的構建進度。
查詢測試
可在功能擴充>查詢測試中進行簡單的搜尋測試,召回引擎版支援的查詢方式有HA查詢、SQL查詢、RESTAPI查詢三種。
選取查詢方式為 HA查詢 後,在 query 輸入框中輸入查詢語句(例如 id:'1',格式參考提示 daogou:part_ids=0|2),設定 cluster(如 general)和 config(如 start:0,hit:10,format:json),提交後頁面下方將展示請求 URL、匹配條數、耗時及各欄位傳回值。
-
【文檔】查詢文法
-
【文檔】召回引擎版RESTFUL API
注意事項
重要
-
付費方式暫時僅支援隨用隨付;
-
購買執行個體時設定的使用者名稱和密碼可在執行個體詳情頁進行修改;
-
叢集名稱在購買執行個體時由系統為使用者指定使用的叢集,使用者暫時無法修改;
-
索引重建需按照每次消耗的資源量付費,詳情可參考召回引擎版計費概述;