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. Uma coleção de pesquisas permite que você alimente aplicativos em suas redes internas e aplicativos voltados para a Internet, como a pesquisa de sites de comércio eletrônico e 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ê concluirá 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** Recomendamos que você use somente caracteres ASCII no `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, transferirá 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/casa](https://console.aws.amazon.com/aos/home ). 1. Escolha **Coleções** no painel de navegação à esquerda e escolha **Criar coleção**. 1. Dê à coleção o nome de **movies** (filmes). 1. Para o 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 **Segurança**, escolha **Criação padrão**. 1. Em **Criptografia**, selecione **Usar Chave pertencente à AWS**. Isso é o AWS KMS key que o OpenSearch Serverless usará para criptografar seus dados. 1. Em **Rede**, configure o acesso à rede para a coleção. + Para o tipo de acesso, selecione **Público**. + Para o tipo de recurso, escolha **Habilitar acesso a OpenSearch endpoints** e **Habilitar acesso a OpenSearch painéis**. Como você fará o upload e pesquisará dados usando OpenSearch painéis, é necessário habilitar os dois. 1. Escolha **Próximo**. 1. Em **Configurar acesso aos dados**, defina as configurações de acesso para a coleção. As [políticas de acesso a dados](serverless-data-access.md) permitem que usuários e funções acessem os dados em uma coleção. Neste tutorial, forneceremos a um único usuário as permissões necessárias para indexar e pesquisar dados na coleção *movies* (filmes). Crie uma única regra que forneça acesso à coleção de *filmes*. Nomeie a regra de **Acesso à coleção de filmes**. 1. Escolha **Adicionar diretores**, **usuários e funções do IAM** e selecione o usuário ou a função que você usará para fazer login nos OpenSearch painéis e indexar dados. Escolha **Salvar**. 1. Em **Permissões de índices**, selecione todas as permissões. 1. Escolha **Próximo**. 1. Para as configurações da política de acesso, escolha **Criar uma nova política de acesso a dados** e nomeie os **filmes** da política. 1. Escolha **Próximo**. 1. Reveja suas configurações da coleção e escolha **Enviar**. Aguarde alguns minutos até que o status da coleção mude para `Active`. ## 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 resumir, 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 ``` ![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/images/serverless-gsg-create.png) 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 à esquerda e escolha **Descobrir**, 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 obter 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 o [comportamento de repetição](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) no *Guia de referência de ferramentas AWS SDKs e ferramentas*. + `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 *movies* (filmes) é usada apenas para fins de teste, você deverá excluí-la quando terminar os testes. **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, talvez você queira tentar alguns dos seguintes exercícios: + Veja opções mais avançadas para a criação de uma coleção. Para saber mais, consulte [Gerenciando coleções Amazon OpenSearch Serverless](serverless-manage.md). + Saiba como configurar políticas de segurança para gerenciar a segurança da coleção em escala. Para saber mais, consulte [Visão geral da segurança no Amazon OpenSearch Serverless](serverless-security.md). + Descubra outras formas de indexar dados em coleções. Para obter mais informações, consulte [Ingestão de dados em coleções Amazon OpenSearch Serverless](serverless-clients.md).