Começando a usar o Amazon OpenSearch Service - OpenSearch Serviço Amazon
Etapa 1: Criar um domínioEtapa 2: carregar dados para indexaçãoEtapa 3: Pesquisar documentosEtapa 4: Excluir um domínio

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

Começando a usar o Amazon OpenSearch Service

Este tutorial mostra como usar o Amazon OpenSearch Service para criar e configurar um domínio de teste. Um domínio OpenSearch de serviço é sinônimo de um OpenSearch cluster. Domínios são clusters com configurações, tipos de instância, contagens de instâncias e recursos de armazenamento especificados por você.

Este tutorial mostra as etapas básicas para colocar um domínio OpenSearch de serviço em funcionamento rapidamente. Para obter informações mais detalhadas, consulte Criação e gerenciamento de domínios OpenSearch do Amazon Service e outros tópicos neste guia. Para obter informações sobre como migrar para o OpenSearch Service a partir de um OpenSearch cluster autogerenciado, consulte. Tutorial: migração para o Amazon OpenSearch Service

Você pode concluir as etapas deste tutorial usando o console OpenSearch de serviço, o AWS CLI, ou o AWS SDK. Para obter informações sobre como instalar e configurar o AWS CLI, veja o AWS Command Line Interface Guia do usuário.

Etapa 1: criar um domínio do Amazon OpenSearch Service

Importante

Este é um tutorial conciso para configurar um domínio de teste do Amazon OpenSearch Service. Não use esse processo para criar domínios de produção. Para obter uma versão abrangente do mesmo processo, consulte Criação e gerenciamento de domínios OpenSearch do Amazon Service.

Um domínio OpenSearch de serviço é sinônimo de um OpenSearch cluster. Domínios são clusters com configurações, tipos de instância, contagens de instâncias e recursos de armazenamento especificados por você. Você pode criar um domínio OpenSearch de serviço usando o console, o AWS CLI, ou o AWS SDKs.

Para criar um domínio OpenSearch de serviço usando o console

  1. Acesse https://aws.amazon.come escolha Entrar no console.

  2. Em Analytics, escolha Amazon OpenSearch Service.

  3. Escolha Criar domínio.

  4. Informe um nome para o domínio. Os exemplos neste tutorial usam o nome movies.

  5. Como método de criação de domínio, escolha Criação padrão.

    nota

    Para configurar rapidamente um domínio de produção com as melhores práticas, você pode escolher Criação fácil. Para fins de desenvolvimento e teste deste tutorial, usaremos a Criação padrão.

  6. Para modelos, escolha dev/teste.

  7. Para a opção de implantação, escolha Domínio com modo de espera.

  8. Em Versão, escolha a versão mais recente.

  9. Por enquanto, ignore as seções Nós de dados, Armazenamento de dados com maior e menor atividade, Nós mestres dedicados, configuração de instantâneos e endpoint personalizado.

  10. Para simplificar este tutorial, use um domínio de acesso público. Sob Rede, selecione Acesso público.

  11. Nas configurações de controle de acesso detalhado, mantenha a caixa de seleção Habilitar o controle de acesso refinado. Selecione Criar usuário principal e forneça um nome de usuário e senha.

  12. Por enquanto, ignore as seções de SAMLautenticação e autenticação do Amazon Cognito.

  13. Para Política de acesso), escolha Use somente controle de acesso refinado. Neste tutorial, o controle de acesso refinado processa a autenticação, não a política de acesso ao domínio.

  14. Ignore o restante das configurações e escolha Criar. Os novos domínios normalmente levam de 15 a 30 minutos para inicializar, mas podem demorar mais dependendo da configuração. Após a inicialização do domínio, selecione-o para abrir o painel de configuração. Anote o endpoint do domínio em Informações gerais (p. ex., https://search-my-domain.us-east-1.es.amazonaws.com), você vai usá-lo na próxima etapa.

Próximo: Carregar dados em um domínio OpenSearch de serviço para indexação

Etapa 2: fazer upload de dados para o Amazon OpenSearch Service para indexação

Importante

Este é um tutorial conciso para fazer o upload de uma pequena quantidade de dados de teste para o Amazon OpenSearch Service. Para obter mais informações sobre como carregar dados em um domínio de produção, consulte Indexação de dados no Amazon Service OpenSearch .

Você pode carregar dados para um domínio de OpenSearch serviço usando a linha de comando ou a maioria das linguagens de programação.

As solicitações de exemplo a seguir usam curl (um HTTP cliente comum) por questões de concisão e conveniência. Clientes como o curl não podem realizar a assinatura da solicitação necessária se suas políticas de acesso IAM especificarem usuários ou funções. Para concluir esse processo com êxito, você deverá usar o controle de acesso refinado com um nome de usuário primário e uma senha, conforne configurados na Etapa 1.

Você pode instalar o curl no Windows e usá-lo no prompt de comando, mas recomendamos usar uma ferramenta como Cygwin ou o Windows Subsystem for Linux. O macOS e a maioria das distribuições do Linux já vêm com curl pré-instalado.

Opção 1: Carregar um único documento

Execute o comando a seguir para adicionar um único documento ao domínio movies:

curl -XPUT -u 'master-user:master-user-password' 'domain-endpoint/movies/_doc/1' -d '{"director": "Burton, Tim", "genre": ["Comedy","Sci-Fi"], "year": 1996, "actor": ["Jack Nicholson","Pierce Brosnan","Sarah Jessica Parker"], "title": "Mars Attacks!"}' -H 'Content-Type: application/json'

No comando, forneça o nome do usuário e a senha que você criou na Etapa 1.

Para obter uma explicação detalhada desse comando e de como fazer solicitações assinadas ao OpenSearch Service, consulteIndexação de dados no Amazon Service OpenSearch .

Opção 2: carregar vários documentos

Para carregar um JSON arquivo que contém vários documentos em um domínio OpenSearch do Serviço

  1. Crie um arquivo local chamado bulk_movies.json. Copie e cole o seguinte conteúdo no arquivo, adicionando uma nova linha no final:

    { "index" : { "_index": "movies", "_id" : "2" } }
{"director": "Frankenheimer, John", "genre": ["Drama", "Mystery", "Thriller", "Crime"], "year": 1962, "actor": ["Lansbury, Angela", "Sinatra, Frank", "Leigh, Janet", "Harvey, Laurence", "Silva, Henry", "Frees, Paul", "Gregory, James", "Bissell, Whit", "McGiver, John", "Parrish, Leslie", "Edwards, James", "Flowers, Bess", "Dhiegh, Khigh", "Payne, Julie", "Kleeb, Helen", "Gray, Joe", "Nalder, Reggie", "Stevens, Bert", "Masters, Michael", "Lowell, Tom"], "title": "The Manchurian Candidate"}
{ "index" : { "_index": "movies", "_id" : "3" } }
{"director": "Baird, Stuart", "genre": ["Action", "Crime", "Thriller"], "year": 1998, "actor": ["Downey Jr., Robert", "Jones, Tommy Lee", "Snipes, Wesley", "Pantoliano, Joe", "Jacob, Ir\u00e8ne", "Nelligan, Kate", "Roebuck, Daniel", "Malahide, Patrick", "Richardson, LaTanya", "Wood, Tom", "Kosik, Thomas", "Stellate, Nick", "Minkoff, Robert", "Brown, Spitfire", "Foster, Reese", "Spielbauer, Bruce", "Mukherji, Kevin", "Cray, Ed", "Fordham, David", "Jett, Charlie"], "title": "U.S. Marshals"}
{ "index" : { "_index": "movies", "_id" : "4" } }
{"director": "Ray, Nicholas", "genre": ["Drama", "Romance"], "year": 1955, "actor": ["Hopper, Dennis", "Wood, Natalie", "Dean, James", "Mineo, Sal", "Backus, Jim", "Platt, Edward", "Ray, Nicholas", "Hopper, William", "Allen, Corey", "Birch, Paul", "Hudson, Rochelle", "Doran, Ann", "Hicks, Chuck", "Leigh, Nelson", "Williams, Robert", "Wessel, Dick", "Bryar, Paul", "Sessions, Almira", "McMahon, David", "Peters Jr., House"], "title": "Rebel Without a Cause"}

  2. Execute o comando a seguir no diretório local em que o arquivo está armazenado para carregar para o domínio movies:

    curl -XPOST -u 'master-user:master-user-password' 'domain-endpoint/movies/_bulk' --data-binary @bulk_movies.json -H 'Content-Type: application/x-ndjson'

Para obter mais informações sobre o formato de arquivo em massa, consulte Indexação de dados no Amazon Service OpenSearch .

Próximo: Pesquisar documentos

Etapa 3: Pesquisar documentos no Amazon OpenSearch Service

Para pesquisar documentos em um domínio do Amazon OpenSearch Service, use a OpenSearch pesquisaAPI. Como alternativa, você pode usar OpenSearch painéis para pesquisar documentos no domínio.

Para pesquisar documentos via linha de comando

Execute o comando a seguir para realizar uma pesquisa no domínio movies usando a palavra mars:

curl -XGET -u 'master-user:master-user-password' 'domain-endpoint/movies/_search?q=mars&pretty=true'

Se você usou dados em massa na página anterior, tente pesquisar rebeldes.

Você verá uma resposta semelhante à seguinte:

{
  "took" : 5,
  "timed_out" : false,
  "_shards" : {
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 1,
      "relation" : "eq"
    },
    "max_score" : 0.2876821,
    "hits" : [
      {
        "_index" : "movies",
        "_type" : "_doc",
        "_id" : "1",
        "_score" : 0.2876821,
        "_source" : {
          "director" : "Burton, Tim",
          "genre" : [
            "Comedy",
            "Sci-Fi"
          ],
          "year" : 1996,
          "actor" : [
            "Jack Nicholson",
            "Pierce Brosnan",
            "Sarah Jessica Parker"
          ],
          "title" : "Mars Attacks!"
        }
      }
    ]
  }
}

Pesquise documentos usando OpenSearch painéis

OpenSearch O Dashboards é uma ferramenta popular de visualização de código aberto projetada para trabalhar com. OpenSearch Ele fornece uma interface de usuário útil para você pesquisar e monitorar seus índices.

Para pesquisar documentos de um domínio OpenSearch de serviço usando painéis

  1. Navegue até os OpenSearch painéis URL do seu domínio. Você pode encontrá-los URL no painel do domínio no console OpenSearch de serviço. O URL seguinte formato é o seguinte:

    domain-endpoint/_dashboards/

  2. Faça login usando o nome de usuário principal e a respectiva senha.

  3. Para usar o Dashboards, é necessário criar pelo menos um padrão de índice. O Dashboards usa esses padrões para identificar quais índices você deseja analisar. Abra o menu esquerdo de navegação, escolha Gerenciamento de pilhas, escolha Padrões de índice e, em seguida, escolha Criar padrão de índice. Para este tutorial, insira movies.

  4. 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 actor e director.

  5. Volte para a página Padrões de índice e verifique se movies está definido como o valor padrão. Caso não esteja, selecione o padrão e escolha o ícone de estrela para torná-lo o valor padrão.

  6. Para começar a pesquisar seus dados, abra novamente o menu esquerdo de navegação e escolha Descobrir.

  7. Na barra de pesquisa, insira mars se você carregou um único documento, ou rebel se você carregou vários documentos. Em seguida, pressione Enter. Você pode tentar pesquisar outros termos, como nomes de atores ou diretores.

Próximo: Excluir um domínio

Etapa 4: Excluir um domínio do Amazon OpenSearch Service

Como o domínio movies deste tutorial é usado apenas para fins de teste, você deverá excluí-lo quando terminar os testes para evitar cobranças.

Para excluir um domínio de OpenSearch serviço do console

  1. Faça login no console do Amazon OpenSearch Service.

  2. Sob Domínios, selecione o domínio movies (filmes).

  3. Escolha Excluir e confirme a exclusão.

Próximas etapas

Agora que você sabe como criar um domínio e indexar dados, talvez você queira tentar alguns dos seguintes exercícios: