Tutorial: Introdução ao Amazon OpenSearch sem Servidor - Amazon OpenSearch Service
Etapa 1: configurar permissõesEtapa 2: criar uma coleçãoEtapa 3: Transferir e pesquisar dadosTratamento de errosEtapa 4: Excluir a coleçãoPróximas etapas

Tutorial: Introdução ao Amazon OpenSearch sem Servidor

Este tutorial o orientará pelas etapas básicas de como montar e executar rapidamente uma coleção de pesquisa do Amazon OpenSearch de tecnologia sem servidor. 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. Para obter informações detalhadas sobre o uso das coleções, consulte Gerenciar coleções do Amazon OpenSearch sem Servidor e outros tópicos nesta aba.

Você concluirá as seguintes etapas neste tutorial:

  1. Configurar permissões

  2. Criar uma coleção

  3. Transferir e pesquisar dados

  4. Excluir a coleção

    nota

    Recomendamos que você use somente caracteres ASCII no IndexName. Se não usar caracteres ASCII no IndexName, as métricas de IndexName no CloudWatch 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 Sem Servidor em geral, é necessário 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 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 mais informações sobre permissões do IAM do OpenSearch Sem Servidor, consulte Gerenciamento de identidade e acesso no Amazon OpenSearch Sem Servidor.

Etapa 2: criar uma coleção

Uma coleção é um grupo de índices do OpenSearch que trabalham juntos para dar suporte a uma workload ou a caso de uso específico.

Para criar uma coleção da tecnologia sem servidor do OpenSearch

  1. Abra o console do Amazon OpenSearch Service em https://console.aws.amazon.com/aos/home.

  2. Escolha Coleções no painel de navegação à esquerda e escolha Criar coleção.

  3. Dê à coleção o nome de movies (filmes).

  4. Para o tipo de coleção, escolha Pesquisar. Para obter mais informações, consulte Choosing a network type (Escolher um tipo de rede).

  5. Em Segurança, escolha Criação padrão.

  6. Em Criptografia, selecione Usar Chave pertencente à AWS. Essa é a AWS KMS key que o OpenSearch Sem Servidor usará para criptografar os dados.

  7. Em Rede, configure o acesso à rede para a coleção.

    • Para o tipo de acesso, selecione Público.

    • Para o tipo de recurso, escolha tanto Habilitar acesso aos endpoints do OpenSearch quanto Habilitar acesso ao OpenSearch Dashboards. Como você transferirá e pesquisará dados usando o OpenSearch Dashboards, você precisará habilitar ambos.

  8. Escolha Próximo.

  9. Em Configurar acesso aos dados, defina as configurações de acesso para a coleção. As políticas de acesso a dados 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.

  10. Escolha Adicionar entidades principais, Usuários e perfis do IAM e selecione o usuário ou perfil que você usará para fazer login no OpenSearch Dashboards e indexar dados. Escolha Salvar.

  11. Em Permissões de índices, selecione todas as permissões.

  12. Escolha Próximo.

  13. 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.

  14. Escolha Próximo.

  15. 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

É possível carregar os dados em uma coleção do OpenSearch Serverless usando o Postman ou o cURL. Para resumir, estes exemplos usam Ferramentas de desenvolvimento no console do 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.

  2. Escolha o URL do OpenSearch Dashboards para a coleção. O URL assume o formato https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

  3. No OpenSearch Dashboards, abra o menu de navegação à esquerda e escolha Ferramentas de desenvolvimento.

  4. 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.

  5. 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
}

  6. Para pesquisar dados no OpenSearch Dashboards, você precisa configurar pelo menos um padrão de índice. O 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.

  7. 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.

  8. Para começar a pesquisar seus dados, abra novamente o painel de navegação à esquerda e escolha Descobrir, ou use a API de pesquisa 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 as unidades de computação do OpenSearch (OCUs) estão sobrecarregadas pelo volume ou pela complexidade das solicitações. Embora a escala do OpenSearch sem Servidor seja ajustada automaticamente para administrar 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 no Guia de referência de SDKs e ferramentas da AWS.

  • HTTP 402: indica que você atingiu o limite máximo de capacidade de unidades computacionais (OCUs) do OpenSearch. 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 da tecnologia sem servidor do OpenSearch

  1. Volte para o console do Amazon OpenSearch Service.

  2. Escolha Coleções no painel de navegação à esquerda e selecione a coleção movies (filmes).

  3. 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: