本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 教學課程：Amazon OpenSearch Serverless 入門
本教學課程說明如何快速啟動和執行 Amazon OpenSearch Serverless *搜尋*集合的基本步驟。透過搜尋集合，您可以為內部網路中的應用程式和面向網際網路的應用程式提供支援，例如電子商務網站搜尋和內容搜尋。
若要了解如何使用*向量搜尋*集合，請參閱 [使用向量搜尋集合](serverless-vector-search.md)。如需使用集合的詳細資訊，請參閱本指南中的 [管理 Amazon OpenSearch Serverless 集合](serverless-manage.md)和其他主題。
您完成本教學課程中的下列步驟：
1. [設定許可](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [建立集合](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [上傳並搜尋資料](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [刪除集合](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**注意**
僅對您的 使用 ASCII 字元`IndexName`。如果您未將 ASCII 字元用於 `IndexName`，CloudWatch 指標`IndexName`中的 會轉換為非 ASCII 字元的 URL 編碼格式。
## 步驟 1：設定許可
若要完成本教學課程並一般使用 OpenSearch Serverless，您必須擁有正確的 IAM 許可。在本教學課程中，您會建立集合、上傳和搜尋資料，然後刪除集合。
使用者或角色必須連接[身分型政策](security-iam-serverless.md#security-iam-serverless-id-based-policies)，該政策包含以下最低許可：
------
#### [ 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 的身分和存取管理](security-iam-serverless.md)。
## 步驟 2：建立集合
集合是一組 OpenSearch 索引，可共同運作以支援特定工作負載或使用案例。
**建立 OpenSearch Serverless 集合**
1. 開啟位於 https：//[https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home) 的 Amazon OpenSearch Service 主控台。
1. 在左側導覽窗格中，選擇**集合**。
1. 選擇 **Create collection** (建立集合)。
1. 對於**名稱**，輸入 `movies`。
1. 針對**集合類型**，選擇**搜尋**。如需詳細資訊，請參閱[選擇集合類型](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase)。
1. 針對**集合建立方法**，選擇**快速建立**。
1. 檢閱預設設定。其中包括集合群組、OpenSearch UI 應用程式設定、使用 加密 AWS 擁有的金鑰、公有網路存取，以及自動產生的資料存取政策。
1. 選擇 **Create collection** (建立集合)。
1. 等待集合狀態變更為 `Active`。這可能需要幾分鐘的時間。
**提示**
本教學課程使用 NextGen Express Create 方法。您也可以從登陸頁面上資訊橫幅中的**快速建立**按鈕存取快速建立，以取得更快的路徑。如需進一步控制加密、網路和資料存取設定，請使用**標準建立**。若要使用 Classic 集合建立精靈，請選擇**切換至 Classic**。如需詳細資訊，請參閱[建立集合](serverless-create.md)。
## 步驟 3：上傳並搜尋資料
您可以使用 [Postman](https://www.postman.com/downloads/) 或 cURL 將資料上傳至 OpenSearch Serverless 集合。為了簡化，這些範例在 OpenSearch Dashboards 主控台中使用**開發工具**。
**為 movies 集合中的資料編製索引和進行搜尋**
1. 在左側導覽窗格中選擇 **Collections** (集合)，然後選擇 **movies** 集合以開啟其詳細資訊頁面。
1. 選擇集合的 OpenSearch Dashboards URL。URL 採用的格式為 `https://dashboards.{{{region}}}.aoss.amazonaws.com/_login/?collectionId={{{collection-id}}}`。
1. 在 OpenSearch Dashboards 中，開啟左側導覽窗格，然後選擇 **Dev Tools** (開發工具)。
1. 若要建立名為 *movies-index* 的單一索引，請傳送以下請求：
```
PUT movies-index{{ }}
```
1. 若要將單一文件的索引編製為 *movies-index*，請傳送以下請求：
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. 若要在 OpenSearch Dashboards 中搜尋資料，您需要設定至少一個索引模式。OpenSearch 使用這些模式來識別您要分析的索引。開啟左側導覽窗格，依序選擇 **Stack Management** (堆疊管理)、**Index Patterns** (索引模式)，然後選擇 **Create index pattern** (建立索引模式)。對於本教學課程，輸入 *movies*。
1. 選擇 **Next step** (下一步)，然後選擇 **Create index pattern** (建立索引模式)。建立模式之後，您可以檢視各種文件欄位，例如 `title` 和 `genre`。
1. 若要開始搜尋資料，請再次開啟左側導覽窗格，然後選擇**探索**，或在**開發工具**中使用[搜尋 API](https://opensearch.org/docs/latest/api-reference/search/)。
## 處理錯誤
當您執行索引和搜尋操作時，您可能會收到下列錯誤回應：
+ `HTTP 507` – 表示發生內部伺服器錯誤。此錯誤通常表示 OpenSearch 運算單位 OCUs) 因請求的磁碟區或複雜性而超載。雖然 OpenSearch Serverless 會自動擴展以管理負載，但部署其他資源可能會延遲。
若要緩解此錯誤，請實作指數退避重試政策。此方法會暫時降低請求率，以有效管理負載。如需詳細資訊，請參閱 SDK *AWS SDKs 和工具參考指南*中的[重試行為](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html)。
+ `HTTP 402` – 表示您已達到 OpenSearch 運算單位 (OCU) 容量上限。最佳化工作負載以減少 OCU 用量或請求增加配額。
## 步驟 4：刪除集合
由於*電影*集合用於測試目的，因此請在完成實驗時將其刪除。
**刪除 OpenSearch Serverless 集合**
1. 返回 Amazon OpenSearch Service 主控台。
1. 在左側導覽窗格中選擇 **Collections** (集合)，然後選擇 **movies** 集合。
1. 選擇 **Delete** (刪除)，並確認刪除。
## 後續步驟
現在您已知道如何建立集合和索引資料，建議您嘗試下列動作：
+ 探索建立集合的更進階選項。如需詳細資訊，請參閱[管理 Amazon OpenSearch Serverless 集合](serverless-manage.md)。
+ 設定安全政策以大規模管理集合安全性。如需詳細資訊，請參閱[Amazon OpenSearch Serverless 的安全概觀](serverless-security.md)。
+ 使用其他方法來將資料索引為集合。如需詳細資訊，請參閱[將資料擷取至 Amazon OpenSearch Serverless 集合](serverless-clients.md)。