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. Para obter informações detalhadas sobre o uso das coleções, consulte Criação, listagem e exclusão de 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

   É recomendável que você use somente ASCII caracteres para o seu. IndexName Se você não usar ASCII caracteres para seuIndexName, as CloudWatch métricas IndexName in serão convertidas em um formato URL codificado para caracteres sem ASCII caracteres.

Etapa 1: configurar permissões

Para concluir este tutorial e usar o OpenSearch Serverless em geral, você deve ter as permissões corretasIAM. 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:

{
  "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 IAM permissões OpenSearch sem servidor, consulte. Identity and Access Management para Amazon OpenSearch Serverless

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.

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. Isso é o AWS KMS key que o OpenSearch Serverless usará para criptografar seus 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 Habilitar acesso a OpenSearch endpoints e Habilitar acesso a OpenSearch painéis. Como você fará o upload e pesquisará dados usando OpenSearch painéis, 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 diretores, IAMusuários e funções e selecione o usuário ou a função que você usará para entrar nos OpenSearch painéis 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

Você pode carregar dados para uma coleção OpenSearch sem servidor usando Postman ou c. URL 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.

2. Escolha os OpenSearch painéis URL para a coleção. O URL assume o formatohttps://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

3. Em OpenSearch Painéis, abra o painel de navegação esquerdo e escolha Dev Tools.

4. Para criar um único índice chamado movies-index, envie a seguinte solicitação:

   PUT movies-index 

   

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

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 esquerdo e escolha Descobrir ou use a pesquisa API nas Ferramentas de Desenvolvimento.

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.

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:

• Veja opções mais avançadas para a criação de uma coleção. Para obter mais informações, consulte Criação, listagem e exclusão de coleções do Amazon OpenSearch Sem Servidor.

• Saiba como configurar políticas de segurança para gerenciar a segurança da coleção em escala. Para obter mais informações, consulte Visão geral da segurança no Amazon OpenSearch Sem Servidor.

• Descubra outras formas de indexar dados em coleções. Para obter mais informações, consulte Ingestão de dados nas coleções do Amazon OpenSearch Sem Servidor.