本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
創建一個 Amazon CloudSearch 域
要使用 Amazon 搜索數據 CloudSearch,您需要做的第一件事就是創建一個搜索域。如果您有多組資料想要供予搜尋,則可以建立多個搜尋網域。在傳送搜尋請求至新的網域之前,您還必須設定存取政策、設定索引欄位並更新您要搜尋的資料。
建立搜尋網域時,您必須為其指定獨一無二的名稱。網域名稱必須以字母或數字開頭,長度至少 3 個字元且不超過 28 個字元。允許的字元為:a-z、0-9 和連字號 (-)。網域名稱中不允許使用大寫字母、底線 (_) 及其他特殊字元。
根據預設,所有新網域都是使用 2013 年 1 月 1 日 API 版本建立的。如果您之前已使用 2011-02-01 API 版本建立搜尋網域,您可以選擇在新網域中使用舊的 API。不過,我們建議在所有新的使用案例中使用 2013-01-01 API。當 2011 年 02 月 01 日的應用程式介面淘汰時,所有網域都需要移轉至 2013 年 1 月 1 日的應用程式介面。
您可以選擇要在哪個 AWS 區域建立您的搜尋網域。一般而言,您應選擇最靠近自身營運地點的區域。例如,如果您居住在歐洲,請在歐洲 (愛爾蘭) 區域 (歐洲-西部 -1) 建立搜尋網域。如需支援的區域和端點的最新清單,請參閱區域與端點。如需如何選擇區域的詳細資訊,請參閱 Amazon 的區域和端點 CloudSearch。
注意
不同區 CloudSearch 域中的 Amazon 網域是完全獨立的。例如,若您在 us-east-1 建立的搜尋網域名為 my-domain 並在 eu-west-1 建立另一網域亦名為 my-domain,該兩個網域將彼此完全獨立且資料互不共享。
每個搜尋網域皆有其獨特的端點,用於上傳資料以供編製索引及提交搜尋請求。網域的文件和搜尋端點在網域生命週期當中會保持不變。例如,名為 imdb-movies 的網域其端點可能像這樣:
doc-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com search-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com
重要
預設情況下,所有 IP 位址對新網域的文件端點和搜尋端點進行存取都將遭到封鎖。您必須為網域設定存取政策,以便能夠向網域的搜尋端點提交搜尋請求並經由命令列或透過網域的文件端點上傳資料。您可以透過 Amazon CloudSearch 主控台上傳文件和搜尋網域,而無需設定存取政策。
您可以使用 Amazon CloudSearch console、aws cloudsearch create-domain
命令或任一種 AWS 開發套件建立搜尋網域。
使用 Amazon CloudSearch 控制台創建域
Amazon 主 CloudSearch 控台可讓您輕鬆建立新的搜尋網域,並提供各種選項來設定索引選項。
建立網域
登入 AWS 管理主控台,然後在 https://console.aws.amazon.com/cloudsearch/home
開啟 Amazon CloudSearch 主控台。 選擇 Create domain(建立網域)。
輸入新網域的名稱。網域名稱必須以字母或數字開頭,長度至少 3 個字元且不超過 28 個字元。網域名稱可包含以下字元:a-z (小寫)、0-9 和 - (連字號)。網域名稱中不允許使用大寫字母、底線 (_) 及其他特殊字元。
您也可以選擇性地設定「想要的執行個體類型」和「所需的複製計數」,以預先調整網域 如需詳細資訊,請參閱 在 Amazon 中設定擴展選項 CloudSearch。
-
選擇下一步。
在設定選項中,選取手動組態,然後選擇下一步。
設定網域的索引欄位。如需說明,請參閱configure indexing options。
-
選擇下一步。
設定網域存取原則。如需說明,請參閱configure access policies。
注意
您若未設定存取政策,便只能透過主控台上傳文件及提交搜尋查詢。依預設,文件和搜尋端點會設定為封鎖所有 IP 位址。
-
選擇下一步。
檢閱網域組態,然後選擇 [建立]。
當網域變成作用中時,網域的文件和搜尋服務端點會顯示在網域儀表板上。屆時,您即可上傳文件以編製索引並開始搜尋您的資料。
使用 AWS CLI 建立網域
您可以使用aws cloudsearch create-domain
指令建立搜尋網域。如需有關安裝與設定 AWS CLI 的資訊,請參閱 AWS Command Line Interface 使用者指南。
建立網域
執行
aws cloudsearch create-domain
命令,並使用--domain-name
選項指定您要建立的網域的名稱。例如,若要建立一個名為 movies 的網域:aws cloudsearch create-domain --domain-name movies { "DomainStatus": { "DomainId": "965407640801/movies", "Created": true, "Deleted": false, "SearchInstanceCount": 0, "DomainName": "movies", "SearchService": {}, "RequiresIndexDocuments": false, "Processing": false, "DocService": {}, "ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies", "SearchPartitionCount": 0 } }
aws cloudsearch create-domain
命令會立即傳回。為新網域建立端點大約需要 10 分鐘的時間。您可以使用 aws cloudsearch describe-domains
命令,檢視網域的狀態與組態摘要。如需詳細資訊,請參閱 獲取有關 Amazon CloudSearch 域的信息。
重要
網域的端點一旦作用中,在網域生命週期當中會保持不變。您應當對端點進行快取處理 - 提交文件或搜尋服務請求之前無須先查詢端點,且若這麼做可能會導致您的請求受到調節。
使用 AWS 開發套件建立 Amazon CloudSearch 網域
AWS 開發套件 (Android 和 iOS 開發套件除外) 支援 Amazon CloudSearch 設定 API 中定義的所有 Amazon CloudSearch 動作,包括。CreateDomain
如需安裝與使用 AWS 開發套件的詳細資訊,請參閱 AWS 軟體開發套件