HarmonyOS 融合搜索為開發者提供搜索引擎級的全文搜索能力，可支持應用內搜索和系統全局搜索，為用戶提供更加準確、高效的搜索體驗。

基本概念

• 全文索引
  記錄字或詞的位置和次數等屬性，建立的倒排索引。
• 全文搜索
  通過全文索引進行匹配查找結果的一種搜索引擎技術。
• 全局搜索
  可以在系統全局統一的入口進行的搜索行為。
• 全局搜索應用
  HarmonyOS 上提供全局搜索入口的應用，一般為桌面下拉框或懸浮搜索框。
• 索引源應用
  通過融合搜索索引接口對其數據建立索引的應用。
• 可搜索配置
  每個索引源應用應該提供一個包括應用包名、是否支持全局搜索等信息的可搜索實體，以便全局搜索應用發起搜索。
• 群組
  經過認證的可信設備圈，可從賬號模塊獲取群組 ID。
• 索引庫
  一種搜索引擎的倒排索引庫，包含多個索引文件的整個目錄構成一個索引庫。
• 索引域
  索引數據的字段名，比如一張圖片有文件名、存儲路徑、大小、拍攝時間等，文件名就是其中的一個索引域。
• 索引屬性
  描述索引域的信息，包括索引類型、是否為主鍵、是否存儲、是否支持分詞等。

運作機制

索引源應用通過融合搜索接口設置可搜索實體，并為其數據內容構建全文索引。全局搜索應用接收用戶發起的搜索請求，遍歷支持全局搜索的可搜索實體，解析用戶輸入并構造查詢條件，最后通過融合搜索接口獲取各應用搜索結果。

圖1 融合搜索運作示意圖

約束與限制

• 構建索引或者發起搜索前，索引源應用必須先設置索引屬性，并且必須有且僅有一個索引域設置為主鍵，且主鍵索引域不能分詞，索引和搜索都會使用到索引屬性。
• 索引源應用的數據發生變動時，開發者應同步通過融合搜索索引接口更新索引，以保證索引和應用原始數據的一致性。
• 批量創建、更新、刪除索引時，應控制單次待索引內容大小，建議分批創建索引，防止內存溢出。
• 分頁搜索和分組搜索應控制每頁返回結果數量，防止內存溢出。
• 構建和搜索本機索引時，應該使用提供的 SearchParameter.DEFAULT_GROUP 作為群組 ID，分布式索引使用通過賬號模塊獲取的群組ID。
• 搜索時需先創建搜索會話，并務必在搜索結束時關閉搜索會話，釋放內存資源。
• 使用融合搜索服務接口需要在“config.json”配置文件中添加“ohos.permission.ACCESS_SEARCH_SERVICE”權限。
• 搜索時的 SearchParamter.DEVICE_ID_LIST 必須與創建索引時的deviceId一致。