Elasticsearch:Início rápido: Criar um cluster e recuperar dados

Crie um cluster do Alibaba Cloud Elasticsearch (ES) e recupere dados em cerca de 45 minutos, incluindo aproximadamente 20 minutos para a criação do cluster.

O que você aprenderá

• Criar e configurar um cluster ES.

• Modelar dados usando o Dev Tools no Kibana.

  O Kibana está integrado ao console do Alibaba Cloud Elasticsearch e não requer instalação manual.

• Inserir dados de amostra e executar diversas operações de busca.

Ao final deste tutorial, você será capaz de criar um índice, ler e gravar dados, além de executar buscas no Alibaba Cloud Elasticsearch.

Versão do ES e custos

Antes de começar, revise as informações abaixo:

• Tipo e versão do ES: Vector Enhanced Edition 8.17.0.

  Esta versão modulariza os principais services de busca com IA, incluindo análise de documentos, fragmentação, incorporação de texto, análise de consultas, recuperação, classificação e integração com modelos de linguagem grandes (LLM). Ela oferece suporte à busca semântica para a construção de aplicações de Geração Aumentada por Recuperação (RAG) e busca multimodal.

• Custo estimado: Este tutorial utiliza o modelo de faturamento pagamento conforme o uso. Se você seguir as especificações e a duração recomendadas, o custo total será inferior a USD 5. Libere o cluster imediatamente após concluir o tutorial para evitar cobranças desnecessárias.

Pré-requisitos

• Registre-se e faça login em uma conta Alibaba Cloud. Certifique-se de que a conta tenha permissões para criar e gerenciar resources do Alibaba Cloud Elasticsearch e da Virtual Private Cloud (VPC).

• Crie uma Virtual Private Cloud (VPC) e um vSwitch e anote a região e a zona. O cluster ES deve estar na mesma região e zona para se conectar à VPC.

Procedimento

Etapa 1: Criar um cluster (cerca de 20 minutos)

1. Na página de criação de cluster, crie um cluster. Configure os parâmetros principais conforme mostrado na tabela abaixo e mantenha os demais parâmetros com seus valores padrão.

   Parâmetro	Descrição
   Billing Method	Selecione pagamento conforme o uso. Essa opção permite liberar o cluster a qualquer momento.
   Region and zone	Região: Selecione a região onde sua VPC e seu vSwitch estão localizados. Zona: Para este tutorial, selecione uma única zona a fim de reduzir o tempo de criação do cluster. Em ambientes de produção, recomenda-se atualizar para uma implantação multizona para maior disponibilidade. Este tutorial utiliza China (Hangzhou) / Zona I.
   Network Type	Selecione a VPC e o vSwitch que você criou.
   Cluster Type e Elasticsearch Version	Vector Enhanced Edition 8.17.0. Este tutorial baseia-se nesta versão.
   Data Node Specifications	Tipo de CPU: Intel 2 vCPU, 4 GiB de memória. Tipo e tamanho de armazenamento do nó de dados: Disco em nuvem SSD, 20 GiB de espaço de armazenamento por nó. Número de nós de dados: 2. Os nós de dados armazenam dados de índice e lidam com operações como criação, recuperação, atualização, exclusão e agregação de documentos.
   	ES_test
   Cluster Name	Defina uma senha personalizada. Você precisará dessa senha para fazer login no Kibana, criar índices e explorar dados.

2. Clique em Password e aguarde cerca de 20 minutos até que o status do cluster mude para Active.

Etapa 2: Configurar e fazer login no Kibana

O acesso público ao Kibana é habilitado por padrão, mas todos os endereços IP são negados por motivos de segurança. Adicione o endereço IP do seu dispositivo à lista de permissões de acesso público antes de usar o console do Kibana.

A autenticação exige duas etapas: primeiro, faça login na sua conta Alibaba Cloud; depois, use as credenciais do seu cluster ES (nome de usuário elastic e a senha definida) para acessar o Kibana.

1. No painel de navegação à esquerda, clique em Buy Now. Na seção Data Visualization, clique em Kibana.

2. Na seção Modify Configuration, modifique a lista de permissões de acesso público do Kibana.

   Endereço IP do dispositivo

   Use a tabela a seguir para encontrar o endereço IP do seu dispositivo.

   Cenário	Endereço IP	Método
   Acessar o Kibana a partir do computador local pela internet.	O endereço IP público do seu computador local. Nota Se o seu computador estiver em uma rede doméstica ou corporativa, adicione o endereço IP de saída público da rede local (LAN).	Execute o comando curl ipinfo.io/ip para descobrir o endereço IP público do seu computador.
   Acessar o Kibana a partir de uma instância ECS pela internet.	Se a instância ECS e o cluster ES estiverem em VPCs diferentes, adicione o endereço IP público da instância ECS à lista de permissões de acesso público do cluster ES.	Faça login no console do ECS e visualize o endereço IP público da instância na lista de instâncias.

   Lista de permissões pública

   Obtenha o endereço IP do seu dispositivo e adicione-o à lista de permissões de acesso público.

   1. Clique em Network Access Configuration à direita do grupo default. Na caixa de diálogo exibida, adicione o endereço IP à lista de permissões.

      Tipo de configuração	Formato e exemplo	Observações
      Formato de endereço IPv4	Endereço IP único: 192.168.0.1 Bloco CIDR: 192.168.0.0/24. Recomendamos consolidar endereços IP individuais em blocos CIDR. É possível configurar no máximo 300 endereços IP ou blocos CIDR para um único cluster. Separe várias entradas com vírgulas (,). Não adicione espaços antes ou depois das vírgulas.	Endereço público padrão: 127.0.0.1, que nega acesso de todos os endereços IPv4. 0.0.0.0/0: Permite acesso de todos os endereços IPv4. Importante Não configure 0.0.0.0/0. Essa configuração representa um alto risco de segurança. Alguns clusters e regiões não suportam 0.0.0.0/0. Consulte a interface do usuário ou as mensagens de erro para obter informações precisas.

   2. Após concluir a configuração, clique em Configure.

3. Clique em OK. Na página de login do Kibana, insira seu nome de usuário e senha. Após o login, você será redirecionado para o console do Kibana.

   • Access over Internet: elastic.

   • Username: A senha definida durante a criação do cluster ES. Caso tenha esquecido a senha, você pode redefini-la.

4. Acesse o console Password e execute o comando GET / para consultar informações do cluster.

   A conexão será bem-sucedida se a resposta contiver um objeto JSON com detalhes do cluster, como número da versão e nome.

Etapa 3: Criar um índice

No Dev Tools do Kibana, execute o comando abaixo para criar um índice chamado product_info e definir um mapeamento para dados de products de gestão de patrimônio.

PUT /product_info
{
  "settings": {
    "number_of_shards": 5,
    "number_of_replicas": 1
  },
  "mappings": {
      "properties": {
        "productName": {
          "type": "text",
          "analyzer": "ik_smart"
        },
        "annual_rate":{
          "type":"keyword"
        },
        "describe": {
          "type": "text",
          "analyzer": "ik_smart"
        }
    }
  }
}

Descrição dos principais parâmetros:

settings: Define a configuração de shards do índice. Por exemplo, esta configuração estabelece 5 shards primários e 1 réplica para cada shard primário.

mappings: Define os campos do índice. Neste caso, são definidos três campos: productName , annual_rate e describe . Campos do tipo text são tokenizados para oferecer suporte à busca de texto completo. Já os campos do tipo keyword servem para correspondência exata de valores. Para mais informações sobre tipos de campo, consulte Tipos de dados de campo .

Verificação: Se a resposta contiver "acknowledged": true e "shards_acknowledged": true, o índice foi criado com sucesso.

Etapa 4: Inserir dados

Execute o seguinte comando para inserir dados de amostra em massa:

POST /product_info/_bulk
{"index":{}}
{"productName":"Wealth Management Product A","annual_rate":"3.2200%","describe":"180-day fixed-term product. Minimum investment: 20,000. Stable returns. Optional push notifications."}
{"index":{}}
{"productName":"Wealth Management Product B","annual_rate":"3.1100%","describe":"90-day scheduled investment product. Minimum investment: 10,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product C","annual_rate":"3.3500%","describe":"270-day scheduled investment product. Minimum investment: 40,000. Daily push notifications for immediately credited returns."}
{"index":{}}
{"productName":"Wealth Management Product D","annual_rate":"3.1200%","describe":"90-day scheduled investment product. Minimum investment: 12,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product E","annual_rate":"3.0100%","describe":"Recommended 30-day scheduled investment product. Minimum investment: 8,000. Daily return message notifications."}
{"index":{}}
{"productName":"Wealth Management Product F","annual_rate":"2.7500%","describe":"Popular short-term product. 3-day term, no fees. Minimum investment: 500. Return notifications by SMS."}

Verificação: Se a resposta contiver "errors": false, os dados foram inseridos com sucesso.

Etapa 5: Buscar dados

GET /product_info/_search
{
  "query": {
    "match": {
      "describe": "Daily push notifications for credited returns"
    }
  }
}

GET /product_info/_search
{
  "query": {
    "range": {
      "annual_rate": {
        "gte": "3.0000%",
        "lte": "3.1300%"
      }
    }
  }
}

Limpar resources e próximos passos

Excluir dados e liberar o cluster

1. Execute o comando abaixo para excluir o índice de teste.

   DELETE /product_info

   A seguinte resposta será retornada:

   {
   "acknowledged" : true
   }

2. Retorne ao console do Alibaba Cloud Elasticsearch.

3. Na lista de clusters, localize o cluster que deseja liberar. Na coluna Developer Tools, clique em > Actions. Selecione Release Cluster e clique em Immediately Delete para liberar o cluster.

   Importante

   Liberar um cluster o exclui permanentemente junto com todos os seus dados. Essa ação não pode ser desfeita. Prossiga com cautela.

Próximos passos

Explore estes tópicos para saber mais sobre o Alibaba Cloud Elasticsearch:

• Ingestão de dados: Colete e migre seus dados de negócios para um cluster ES.

  Antes da migração, verifique se é necessário atualizar a configuração do cluster com base no volume de dados.

• Ajuste de desempenho: Explore técnicas de design de índice e otimização de consultas para melhorar o desempenho do cluster.

• Visualização no Kibana: Aprenda a usar resources do Kibana, como Discover e Dashboard, para criar painéis de visualização de dados.