View a markdown version of this page

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

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. Para obter informações detalhadas sobre o uso das coleções, consulte Gerenciando coleções Amazon OpenSearch Serverless e outros tópicos nesta aba.

Você conclui 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

    Use somente caracteres ASCII para o seu. IndexName Se você não usar caracteres ASCII para o seuIndexName, 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 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

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.

  2. No painel de navegação esquerdo, escolha Coleções.

  3. Escolha Criar coleção.

  4. Em Nome, digite movies.

  5. Em Tipo de coleção, escolha Pesquisar. Para saber mais, consulte Choosing a network type (Escolher um tipo de rede).

  6. Em Método de criação de coleção, escolha Express Create.

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

  8. Escolha Criar coleção.

  9. Aguarde até que o status da coleta mude paraActive. 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.

Etapa 3: Transferir e pesquisar dados

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

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

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

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

    PUT movies-index
    OpenSearch Console de painéis mostrando a solicitação PUT para o índice de filmes com status de resposta 200.

  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 Discover ou use a API de pesquisa 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 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.

  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, você pode tentar o seguinte: