OpenSearch：快速入門

前提條件

1. 成功註冊阿里雲帳號並通過實名認證。

2. 首次登入阿里雲控制台時，會提示先建立AccessKey才能繼續使用。

   • 建立及使用應用依賴AccessKey參數，主帳號下AccessKey參數不可為空。

   • 在為主帳號建立AccessKey參數後，還可以再建立RAM子帳號AccessKey通過RAM子帳號進行訪問，RAM子帳號賦予對應存取權限，請參考訪問鑒權規則。

步驟一：購買應用

登入OpenSearch控制台，頁面左上方選擇OpenSearch-高效能檢索版，進入執行個體管理頁，單擊建立應用。

購買應用分為：預付費（訂用帳戶）以及後付費（隨用隨付）。

在購買頁面中，選擇地區和可用性區域（如華南1（深圳）、華北2（北京）等），填寫應用程式名稱（應用程式名稱建立後無法修改），並選擇叢集偏好（獨享叢集-通用型、獨享叢集-計算型、獨享叢集-儲存型或共用叢集-通用型）。

在購買頁面中，配置儲存容量（如 100 GB）、計算資源（如 800 LCU）、計費周期（可選 1–6 個月，支援勾選到期自動續約）和資源群組（預設為預設資源群組），然後單擊立即購買完成下單。

步驟二：配置應用

應用初始化完成後，狀態變更為待配置，此時可以單擊配置進入下一步定義應用結構：

配置應用嚮導分為四個步驟：應用結構 → 索引結構 → 資料來源 → 完成。在第一步中，選擇建立應用結構的方式，可選項包括通過資料來源建立、手動建立、通過模板建立和上傳文檔建立，選擇後單擊下一步。

定義應用結構

目前提供了 4 種應用結構建立方式。

定義應用結構流程：

1. 通過模板建立應用結構。使用者可以將自己定義的應用結構建立成模板，可以通過已有模板快速建立出一個新的應用。

2. 通過上傳文檔建立應用結構。您可以上傳已有的資料檔案（僅支援JSON格式），系統會自動解析並建立出初始的應用結構（注意欄位類型等需要重新定義）。

3. 通過資料來源建立應用結構。適用於通過RDS、MaxCompute等資料來源同步的情境，可以快速由源表結構建立出初始的應用結構，節省手動構造的工作量，降低出錯機率。這裡以RDS為例，其他資料來源操作類似，具體詳見資料來源配置：

   選擇通過資料來源建立 Tab 後，在右側彈出的選擇資料來源面板中選擇 RDS，然後單擊+ 建立資料庫。

   在串連資料庫對話方塊中，填寫RDS 執行個體 ID、資料庫名、使用者名稱和密碼，然後單擊串連。

4. 通過手動建立應用結構，非以上三種情境使用。

   在手動建立頁面，輸入表名（如 main），並選擇主表。在欄位定義地區，設定欄位名稱（如 id、name），為其中一個欄位選中主鍵選項按鈕，並為每個欄位選擇類型（如 INT、LITERAL）。欄位類型的選擇會影響後續配置索引和屬性欄位。單擊 + 可添加更多欄位。

定義索引結構

• 需放到 query子句中的欄位，必須建立為索引（浮點型欄位不支援建立為索引），詳情請參見OpenSearch表結構。

• 需放到 filter子句，sort子句，及函數中涉及欄位有明確標識，需設定為屬性的欄位必須建立為屬性欄位。

• 分詞欄位類型無法配置為屬性欄位，例如 TEXT，SHORT_TEXT等都不支援，只支援數值欄位類型及不分詞欄位類型配置為屬性欄位，例如 int，int_array，float，float_array，double，double_array，literal，literal_array 等欄位類型。

  在索引結構步驟中，需配置三部分內容：索引欄位列表，設定索引名稱、包含欄位及分析方式（如中文 - 通用分析或關鍵字），使用樣本形如 query=default:"雲搜尋"；屬性欄位列表，將欄位添加為屬性欄位後可在 filter、aggregate、sort、distinct 子句中使用，樣本 filter=id>100000；預設展示欄位列表，將欄位添加為展示欄位後搜尋結果中將返回該欄位的值。配置完成後單擊下一步進入資料來源配置。

同步資料來源

1. 首先關聯資料來源，關聯成功後，選擇資料表，單擊>>選中後，確認。

2. 確認後預設進入欄位對應介面，選擇添加資料，OpenSearch應用欄位與資料來源欄位名一致會自動對應，若不一致則需要手動添加。

3. 欄位對應介面可以同時設定資料來源外掛程式，外掛程式使用及說明文檔，請單擊此處：

   說明

   若需要資料來源即時同步功能，可以參考：DTS即時同步。

4. 建立完成

步驟三：搜尋測試

資料上傳成功後就可以開始搜尋體驗，我們在控制台中內建了搜尋測試頁面方便使用者搜尋測試，主要包含查詢子句和查詢參數，可以根據具體搜尋需求自行配置進行搜尋測試（詳情請參見API概覽及SDK簡介），此處以控制台中搜尋測試頁面為例。通過單擊子句或參數後的+按鈕，在彈出的下拉框中選擇添加需要的查詢子句或參數，再填寫對應查詢子句或參數內容，最後單擊搜尋按鈕進行搜尋效果測試。

使用方法

1. 左側導覽列，功能擴充下進入搜尋測試頁。輸入必填參數query子句。

   選擇線上應用，在 config 子句中設定 start:0,hit:10,format:fulljson，單擊搜尋查看返回結果。

2. 同時可以添加更多的子句以及參數。

   單擊+按鈕，在下拉式功能表中選擇要添加的子句類型，包括過濾子句（filter）、排序子句（sort）、打散子句（distinct）、統計子句（aggregate）、自訂子句（kvpairs）和配置子句（config）。

   單擊參數旁的+按鈕，在下拉式功能表中選擇需要添加的參數。選擇性參數包括：展示欄位（fetch_fields）、查詢分析（qp）、粗排運算式（first_rank_name）、精排運算式（second_rank_name）、精排外掛程式類型（second_rank_type）、結果摘要配置（summary）、類目預測（category_prediction）、原始Query（raw_query）、重查策略（re_search）、商務資訊（biz）、搜尋ReqId（from_request_id）、使用者ID（user_id）、A/BTest（abtest）、禁用參數（disable）和自訂參數（custom）。

擴充內容

子句說明

查詢子句-query子句。

過濾子句-filter子句。

排序子句-sort子句。

打散子句-distinct子句。

統計子句-aggregate子句。

自訂子句-kvpair子句。

翻頁子句-config子句。

參數說明

展示欄位fetch_fields，多個展示欄位按分號分隔。

查詢規則qp，設定查詢分析的名稱。

粗排運算式first_rank_name，設定基礎排序的名稱。

精排運算式second_rank_name，設定業務排序的名稱。

結果摘要配置-summary，請參見搜尋結果摘要。

類目預測和原始Query用法：設定類目預測名稱以及查詢詞。

重查策略re_search，請參見搜尋處理。

商務資訊biz，使用者ID，請參見搜尋處理。

A/B Test，設定A/B Test的名稱。

禁用參數disable，設定想禁用的功能，例如disable=qp。

更多進階功能，請查看對應功能的產品文檔，文檔中都有操作流程步驟。