教學課程:Amazon OpenSearch Serverless 入門 - Amazon OpenSearch Service

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

教學課程:Amazon OpenSearch Serverless 入門

本教學課程將逐步引導您快速啟動和執行 Amazon OpenSearch Serverless 搜尋集合的基本步驟。搜尋集合可讓您為內部網路中的應用程式和面向網際網路的應用程式提供支援,例如電子商務網站搜尋和內容搜尋。

若要了解如何使用向量搜尋集合,請參閱 使用向量搜尋集合。如需使用集合的詳細資訊,請參閱 建立、列出和刪除 Amazon OpenSearch 無伺服器集合和本指南中的其他主題。

在本教學課程中,您會完成下列步驟:

  1. 設定許可

  2. 建立集合

  3. 上傳並搜尋資料

  4. 刪除集合

    注意

    建議您只將ASCII字元用於 IndexName。如果您不使用 的ASCII字元IndexName,則 IndexName中的 CloudWatch 指標會轉換為非ASCII 字元的URL編碼格式。

步驟 1:設定許可

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

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

{ "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 伺服器IAM許可的詳細資訊,請參閱Amazon OpenSearch Serverless 的 Identity and Access Management

步驟 2:建立集合

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

建立 Serverless OpenSearch 集合
  1. https://console.aws.amazon.com/aos/在家中開啟 Amazon OpenSearch Service 主控台。

  2. 在左側導覽窗格中選擇 Collections (集合),然後選擇 Create collection (建立集合)。

  3. 將集合命名為 movies

  4. 對於集合類型,選擇 Search (搜尋)。如需詳細資訊,請參閱選擇集合類型

  5. 針對安全性,選擇標準建立

  6. 加密下,選取使用 AWS 擁有的金鑰。這是 AWS KMS key OpenSearch Serverless 用來加密資料的 。

  7. Network (網路) 下,設定集合的網路設定。

    • 對於存取類型,選取 Public (公用)。

    • 針對資源類型,選擇啟用 OpenSearch 端點存取啟用 OpenSearch 儀表板存取。由於您將使用 OpenSearch Dashboards 上傳和搜尋資料,因此您需要啟用兩者。

  8. 選擇 Next (下一步)

  9. 對於 Configure data access (設定資料存取),請設定集合的存取設定。資料存取政策讓使用者和角色可以存取集合中的資料。在本教學課程中,我們將為單一使用者提供為 movies 集合中資料編製索引和進行搜尋所需的許可。

    建立可存取 movies 集合的單一規則。將規則命名為 Movies collection access (電影集合存取)。

  10. 選擇新增主體IAM使用者和角色,然後選取您將用來登入 OpenSearch 儀表板和索引資料的使用者或角色。選擇 Save (儲存)。

  11. Index permissions (索引許可) 下,選取所有許可。

  12. 選擇 Next (下一步)

  13. 對於存取政策設定,請選擇 Create a new data access policy (建立新的資料存取政策) 並命名政策 movies

  14. 選擇 Next (下一步)

  15. 檢閱集合設定,然後選擇 Submit (提交)。等待幾分鐘,讓收集狀態變成 Active

步驟 3:上傳並搜尋資料

您可以使用 Postman 或 c 將資料上傳至無 OpenSearch 伺服器集合URL。為了簡潔起見,這些範例使用 OpenSearch Dashboards 主控台中的開發工具

為 movies 集合中的資料編製索引和進行搜尋
  1. 在左側導覽窗格中選擇 Collections (集合),然後選擇 movies 集合以開啟其詳細資訊頁面。

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

  3. 在 OpenSearch 儀表板中,開啟左側導覽窗格,然後選擇開發工具

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

    PUT movies-index
    OpenSearch Dashboards console showing PUT request for movies-index with JSON response.
  5. 若要將單一文件的索引編製為 movies-index,請傳送以下請求:

    PUT movies-index/_doc/1 { "title": "Shawshank Redemption", "genre": "Drama", "year": 1994 }
  6. 若要在 OpenSearch 儀表板中搜尋資料,您需要設定至少一個索引模式。 OpenSearch 使用這些模式來識別您要分析的索引。開啟左側導覽窗格,依序選擇 Stack Management (堆疊管理)、Index Patterns (索引模式),然後選擇 Create index pattern (建立索引模式)。對於本教學課程,輸入 movies

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

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

步驟 4:刪除集合

movies 集合用於測試目的,因此請確保在完成實驗後將其刪除。

刪除 OpenSearch Serverless 集合
  1. 返回 Amazon OpenSearch Service 主控台。

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

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

後續步驟

您現在已知道如何建立集合並為資料編製索引,您可能想要嘗試以下一些練習: