View a markdown version of this page

教學課程：Amazon OpenSearch Serverless 入門 - Amazon OpenSearch Service
步驟 1：設定許可步驟 2：建立集合步驟 3：上傳並搜尋資料處理錯誤步驟 4：刪除集合後續步驟

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

教學課程：Amazon OpenSearch Serverless 入門

本教學課程說明如何快速啟動和執行 Amazon OpenSearch Serverless 搜尋集合的基本步驟。透過搜尋集合，您可以為內部網路中的應用程式和面向網際網路的應用程式提供支援，例如電子商務網站搜尋和內容搜尋。

若要了解如何使用向量搜尋集合，請參閱 使用向量搜尋集合。如需使用集合的詳細資訊，請參閱本指南中的 管理 Amazon OpenSearch Serverless 集合和其他主題。

您完成本教學課程中的下列步驟：

  1. 設定許可

  2. 建立集合

  3. 上傳並搜尋資料

  4. 刪除集合

    注意

    僅對您的 使用 ASCII 字元IndexName。如果您未將 ASCII 字元用於 IndexName，CloudWatch 指標IndexName中的 會轉換為非 ASCII 字元的 URL 編碼格式。

步驟 1：設定許可

若要完成本教學課程並一般使用 OpenSearch Serverless，您必須擁有正確的 IAM 許可。在本教學課程中，您會建立集合、上傳和搜尋資料，然後刪除集合。

使用者或角色必須連接身分型政策，該政策包含以下最低許可：

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Action": [
        "aoss:CreateCollection",
        "aoss:ListCollections",
        "aoss:BatchGetCollection",
        "aoss:DeleteCollection",
        "aoss:CreateAccessPolicy",
        "aoss:ListAccessPolicies",
        "aoss:UpdateAccessPolicy",
        "aoss:CreateSecurityPolicy",
        "aoss:GetSecurityPolicy",
        "aoss:UpdateSecurityPolicy",
        "iam:ListUsers",
        "iam:ListRoles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

如需有關 OpenSearch Serverless IAM 許可的詳細資訊，請參閱 Amazon OpenSearch Serverless 的身分和存取管理。

步驟 2：建立集合

集合是一組 OpenSearch 索引，可共同運作以支援特定工作負載或使用案例。

建立 OpenSearch Serverless 集合

  1. 開啟位於 https：//https://console.aws.amazon.com/aos/home 的 Amazon OpenSearch Service 主控台。

  2. 在左側導覽窗格中，選擇集合。

  3. 選擇 Create collection (建立集合)。

  4. 對於名稱，輸入 movies。

  5. 針對集合類型，選擇搜尋。如需詳細資訊，請參閱選擇集合類型。

  6. 針對集合建立方法，選擇快速建立。

  7. 檢閱預設設定。其中包括集合群組、OpenSearch UI 應用程式設定、使用 加密 AWS 擁有的金鑰、公有網路存取，以及自動產生的資料存取政策。

  8. 選擇 Create collection (建立集合)。

  9. 等待集合狀態變更為 Active。這可能需要幾分鐘的時間。

提示

本教學課程使用 NextGen Express Create 方法。您也可以從登陸頁面上資訊橫幅中的快速建立按鈕存取快速建立，以取得更快的路徑。如需進一步控制加密、網路和資料存取設定，請使用標準建立。若要使用 Classic 集合建立精靈，請選擇切換至 Classic。如需詳細資訊，請參閱建立集合。

步驟 3：上傳並搜尋資料

您可以使用 Postman 或 cURL 將資料上傳至 OpenSearch Serverless 集合。為了簡化，這些範例在 OpenSearch Dashboards 主控台中使用開發工具。

為 movies 集合中的資料編製索引和進行搜尋

  1. 在左側導覽窗格中選擇 Collections (集合)，然後選擇 movies 集合以開啟其詳細資訊頁面。

  2. 選擇集合的 OpenSearch Dashboards URL。URL 採用的格式為 https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}。

  3. 在 OpenSearch Dashboards 中，開啟左側導覽窗格，然後選擇 Dev Tools (開發工具)。

  4. 若要建立名為 movies-index 的單一索引，請傳送以下請求：

    PUT movies-index
    OpenSearch 儀表板主控台顯示對回應狀態為 200 的 movies-index 的 PUT 請求。

  5. 若要將單一文件的索引編製為 movies-index，請傳送以下請求：

    PUT movies-index/_doc/1
{ 
  "title": "Shawshank Redemption",
  "genre": "Drama",
  "year": 1994
}

  6. 若要在 OpenSearch Dashboards 中搜尋資料，您需要設定至少一個索引模式。OpenSearch 使用這些模式來識別您要分析的索引。開啟左側導覽窗格，依序選擇 Stack Management (堆疊管理)、Index Patterns (索引模式)，然後選擇 Create index pattern (建立索引模式)。對於本教學課程，輸入 movies。

  7. 選擇 Next step (下一步)，然後選擇 Create index pattern (建立索引模式)。建立模式之後，您可以檢視各種文件欄位，例如 title 和 genre。

  8. 若要開始搜尋資料，請再次開啟左側導覽窗格，然後選擇探索，或在開發工具中使用搜尋 API。

處理錯誤

當您執行索引和搜尋操作時，您可能會收到下列錯誤回應：

  • HTTP 507 – 表示發生內部伺服器錯誤。此錯誤通常表示 OpenSearch 運算單位 OCUs) 因請求的磁碟區或複雜性而超載。雖然 OpenSearch Serverless 會自動擴展以管理負載，但部署其他資源可能會延遲。

    若要緩解此錯誤，請實作指數退避重試政策。此方法會暫時降低請求率，以有效管理負載。如需詳細資訊，請參閱 SDK AWS SDKs 和工具參考指南中的重試行為。

  • HTTP 402 – 表示您已達到 OpenSearch 運算單位 (OCU) 容量上限。最佳化工作負載以減少 OCU 用量或請求增加配額。

步驟 4：刪除集合

由於電影集合用於測試目的，因此請在完成實驗時將其刪除。

刪除 OpenSearch Serverless 集合

  1. 返回 Amazon OpenSearch Service 主控台。

  2. 在左側導覽窗格中選擇 Collections (集合)，然後選擇 movies 集合。

  3. 選擇 Delete (刪除)，並確認刪除。

後續步驟

現在您已知道如何建立集合和索引資料，建議您嘗試下列動作：