As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Tutorial: Introdução ao Amazon OpenSearch Serverless
Este tutorial mostra as etapas básicas para colocar uma coleção de *pesquisa* Amazon OpenSearch Serverless em funcionamento rapidamente. Com uma coleção de pesquisas, você pode potencializar aplicativos em suas redes internas e aplicativos voltados para a Internet, como pesquisa em sites de comércio eletrônico e pesquisa de conteúdo.
Para saber como usar uma coleção de *pesquisa vetorial*, consulte [Trabalho com coleções de pesquisa vetorial](serverless-vector-search.md). Para obter informações detalhadas sobre o uso das coleções, consulte [Gerenciando coleções Amazon OpenSearch Serverless](serverless-manage.md) e outros tópicos nesta aba.
Você conclui as seguintes etapas neste tutorial:
1. [Configurar permissões](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [Criar uma coleção](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [Transferir e pesquisar dados](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [Excluir a coleção](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**nota**
Use somente caracteres ASCII para o seu. `IndexName` Se você não usar caracteres ASCII para o seu`IndexName`, as CloudWatch métricas `IndexName` in serão convertidas em um formato codificado de URL para caracteres não ASCII.
## Etapa 1: configurar permissões
Para concluir este tutorial e usar o OpenSearch Serverless em geral, você deve ter as permissões corretas do IAM. Neste tutorial, você criará uma coleção, carregará e pesquisará dados e, em seguida, excluirá a coleção.
Seu usuário ou função deve ter uma [política baseada em identidade](security-iam-serverless.md#security-iam-serverless-id-based-policies) anexada com as seguintes permissões mínimas:
------
#### [ 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": "*"
}
]
}
```
------
Para obter mais informações sobre as permissões do IAM OpenSearch sem servidor, consulte. [Identity and Access Management para Amazon OpenSearch Serverless](security-iam-serverless.md)
## Etapa 2: criar uma coleção
Uma coleção é um grupo de OpenSearch índices que trabalham juntos para dar suporte a uma carga de trabalho ou caso de uso específico.
**Para criar uma coleção OpenSearch sem servidor**
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home).
1. No painel de navegação esquerdo, escolha **Coleções**.
1. Escolha **Criar coleção**.
1. Em **Nome**, digite `movies`.
1. Em **Tipo de coleção**, escolha **Pesquisar**. Para saber mais, consulte [Choosing a network type](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase) (Escolher um tipo de rede).
1. Em **Método de criação de coleção**, escolha **Express Create**.
1. Reveja as configurações padrão. Isso inclui o grupo de coleta, as configurações do aplicativo de OpenSearch interface do usuário, a criptografia com um Chave pertencente à AWS, o acesso à rede pública e a política de acesso a dados gerada automaticamente.
1. Escolha **Criar coleção**.
1. Aguarde até que o status da coleta mude para`Active`. Isso pode demorar vários minutos.
**dica**
Este tutorial usa o método NextGen Express Create. Você também pode acessar o Express Create a partir do botão **Express create** no banner de informações na página inicial para um caminho mais rápido. Para obter mais controle sobre as configurações de criptografia, rede e acesso a dados, use o **Standard Create**. Para usar o assistente de criação de coleção Classic, escolha **Alternar para Classic**. Para obter mais informações, consulte [Criação de coleções](serverless-create.md).
## Etapa 3: Transferir e pesquisar dados
Você pode carregar dados para uma coleção OpenSearch sem servidor usando [Postman ou](https://www.postman.com/downloads/) cURL. Para simplificar, esses exemplos usam **Dev Tools** no console OpenSearch Dashboards.
**Para indexar e pesquisar dados na coleção de filmes**
1. Escolha **Coleções** no painel de navegação à esquerda e escolha a coleção **movies** (filmes) para abrir sua página de detalhes.
1. Escolha o URL dos OpenSearch painéis para a coleção. O URL assume o formato `https://dashboards.{{{region}}}.aoss.amazonaws.com/_login/?collectionId={{{collection-id}}}`.
1. Em OpenSearch Painéis, abra o painel de navegação esquerdo e escolha Ferramentas de **desenvolvimento**.
1. Para criar um único índice chamado *movies-index*, envie a seguinte solicitação:
```
PUT movies-index{{ }}
```
1. Para indexar um único documento em *movies-index*, envie a seguinte solicitação:
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. Para pesquisar dados em OpenSearch painéis, você precisa configurar pelo menos um padrão de índice. OpenSearch usa esses padrões para identificar quais índices você deseja analisar. Abra o painel de navegação à esquerda, escolha **Gerenciamento de pilhas**, **Padrões de índice** e, em seguida, escolha **Criar padrão de índice**. Para este tutorial, insira *movies*.
1. Escolha **Próxima etapa** e, em seguida, **Criar padrão de índice**. Depois que o padrão é criado, você pode visualizar os vários campos do documento, como `title` e `genre`.
1. Para começar a pesquisar seus dados, abra novamente o painel de navegação esquerdo e escolha **Discover** ou use a [API de pesquisa](https://opensearch.org/docs/latest/api-reference/search/) nas **Ferramentas de Desenvolvimento**.
## Tratamento de erros
Ao executar operações de indexação e pesquisa, você pode receber as seguintes respostas de erro:
+ `HTTP 507`: indica que ocorreu um erro interno do servidor. Esse erro geralmente indica que suas unidades de OpenSearch computação (OCUs) estão sobrecarregadas pelo volume ou pela complexidade de suas solicitações. Embora o OpenSearch Serverless seja escalado automaticamente para gerenciar a carga, pode haver um atraso na implantação de recursos adicionais.
Para mitigar esse erro, implemente uma política de repetição de tentativa com recuo exponencial. Essa abordagem reduz temporariamente a taxa de solicitações para administrar a carga com eficiência. Para obter mais detalhes, consulte [Comportamento de repetições de tentativa](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) no *Guia de referência de SDKs e ferramentas da AWS *.
+ `HTTP 402`— Indica que você atingiu o limite máximo de capacidade da unidade OpenSearch computacional (OCU). Otimize a workload para reduzir o uso de OCUs ou solicite um aumento de cota.
## Etapa 4: Excluir a coleção
Como a coleção de *filmes* é para fins de teste, exclua-a quando terminar de experimentar.
**Para excluir uma coleção OpenSearch sem servidor**
1. Volte para o console do Amazon OpenSearch Service.
1. Escolha **Coleções** no painel de navegação à esquerda e selecione a coleção **movies** (filmes).
1. Escolha **Excluir** e confirme a exclusão.
## Próximas etapas
Agora que você sabe como criar uma coleção e indexar dados, você pode tentar o seguinte:
+ Explore opções mais avançadas para criar uma coleção. Para obter mais informações, consulte [Gerenciando coleções Amazon OpenSearch Serverless](serverless-manage.md).
+ Configure políticas de segurança para gerenciar a segurança da coleção em grande escala. Para obter mais informações, consulte [Visão geral da segurança no Amazon OpenSearch Serverless](serverless-security.md).
+ Use outros métodos para indexar dados em coleções. Para obter mais informações, consulte [Ingestão de dados em coleções Amazon OpenSearch Serverless](serverless-clients.md).