Este tutorial orienta desenvolvedores que estão começando a usar o Alibaba Cloud Elasticsearch (ES) em todo o fluxo, desde a criação do cluster até a recuperação de dados. O tutorial leva cerca de 45 minutos, incluindo aproximadamente 20 minutos de espera para a criação do cluster.
O que você aprenderá
Crie e configure um cluster ES.
Modele dados usando o Developer Tools no Kibana. O Kibana é um dos componentes principais do ES — ele permite explorar, analisar e apresentar os dados armazenados no ES de forma visual e intuitiva. O Kibana já vem integrado ao console do ES, portanto não é necessário instale-lo manualmente.
Insira dados de exemplo e execute diversas operações de busca. Ao concluir este tutorial, você será capaz de criar um índice, ler e gravar dados, e execute pesquisas no ES.
Versão do ES e custos
Antes de começar, revise as informações essenciais sobre este período de avaliação:
Tipo e versão do ES: Vector Enhanced Edition 8.17.0. Essa edição modulariza os serviços de algoritmos centrais do pipeline de busca com IA, incluindo análise de documentos, fragmentação, embedding de texto, análise de consultas, recuperação, ranqueamento e integração com modelos de linguagem de grande porte (LLM). Ela oferece suporte a busca semântica, Retrieval-Augmented Generation (RAG) e busca multimodal.
Custo estimado: Este tutorial usa faturamento por pagamento conforme o uso e aplica uma configuração mínima para manter o custo reduzido: zona única, menores especificações de nó e espaço de armazenamento disponíveis, sem nó master dedicado e sem recursos avançados que geram cobranças adicionais. O procedimento descrito neste tópico leva cerca de 45 minutos. Se você liberar o cluster imediatamente após concluir, o custo total estimado será inferior a USD 5.
Com a configuração recomendada neste tópico, você paga por apenas três itens de pagamento conforme o uso: especificações do nó de dados, espaço de armazenamento do nó de dados e especificações do nó Kibana. Consulte os itens de faturamento e o preço unitário de cada um na parte inferior da página de compra.
Os clusters ES são cobrados por hora, e as tarifas continuam acumulando enquanto o cluster estiver em execução. Após o período de avaliação, libere o cluster imediatamente seguindo as instruções em "Limpar recursos e próximas etapas" neste tópico para evitar cobranças desnecessárias.
Pré-requisitos
Registre-se e faça login em uma conta Alibaba Cloud. Verifique se a conta tem permissões para criar e gerencie recursos como Elasticsearch e Virtual Private Cloud (VPC).
Crie a VPC and a vSwitch e registre a região e a zona onde o VPC e o vSwitch residem. Ao criar o cluster ES posteriormente, selecione a mesma região e zona; caso contrário, o cluster não poderá ser associado ao VPC e ao vSwitch.
Procedimento
Etapa 1: Crie um cluster (cerca de 20 minutos)
Faça login no console do Alibaba Cloud Elasticsearch. Na página Elasticsearch Clusters, clique em Create para acessar a página de compra do cluster. Configure os parâmetros principais a seguir e mantenha os demais com seus valores padrão.
| Parâmetro | Descrição |
| Billing Method | Pay-as-you-go. Você pode liberar o cluster a qualquer momento. |
Região e zona |
Se você mantiver três ou duas zonas, o número de nós de dados deverá ser no mínimo 3 e múltiplo de 3, portanto não será possível usar os 2 nós de dados configurados neste tutorial. |
| Network Type | Selecione o VPC e o vSwitch que você criou. |
Cluster Type e Elasticsearch Version | Vector Enhanced Edition 8.17.0. Este tutorial é baseado nessa versão. |
Cenário e recursos avançados | Mantenha o cenário de recuperação padrão. Dois recursos avançados são ativados por padrão nesse cenário. Trate-os da seguinte forma:
|
| Data Node Specifications |
|
Dedicated Master Node | Selecionado por padrão, com três nós de 2 vCPUs e 4 GiB de memória cada. Como este tutorial é um cenário de avaliação, desmarque a caixa de seleção do nó master dedicado para reduzir o custo. O nó master dedicado é responsável pelo gerenciamento do cluster, incluindo os metadados. Ao desmarcar a opção, a página exibirá um aviso de risco de split-brain para os dois nós de dados. Você pode ignorar esse aviso em uma avaliação funcional de curta duração, mas ative o nó master dedicado antes de iniciar cargas de trabalho em produção. |
| Cluster Name |
|
| Password | Defina uma senha personalizada. Você usará essa senha posteriormente para fazer login no Kibana, criar índices e explorar dados. |
Clique em Buy Now e aguarde cerca de 20 minutos até que o status do cluster mude para Active. Em seguida, prossiga para a próxima etapa.
Etapa 2: Configure e acesse o Kibana
O endpoint público do Kibana é ativado por padrão. Por razões de segurança, o acesso pela rede pública nega todos os endereços IP por padrão. Para acessar o Kibana, adicione o endereço IP do dispositivo desejado à lista de permissões.
A autenticação de acesso usa verificação em dois fatores. Primeiro, faça login na sua conta Alibaba Cloud. Depois, realize um segundo login com as credenciais de acesso do cluster ES, sendo o nome de usuário fixo como elastic com a senha de login correspondente.
No painel de navegação à esquerda, clique em Data Visualization. Na seção Kibana, clique em Modify Configuration.
Na seção Network Access Configuration, configure a lista de permissões de acesso público do Kibana.
Obtenha o endereço IP do seu dispositivo
Obtenha o endereço IP do dispositivo desejado conforme os cenários a seguir.
|
Cenário |
Endereço IP a obter |
Como obtê-lo |
|
Acessar o Kibana a partir de um dispositivo local pela internet. |
O endereço IP público do dispositivo local. Se o dispositivo estiver em uma rede home ou em uma rede local (LAN) corporativa, adicione o endereço IP de saída público da LAN. |
Execute o comando |
|
Acessar o Kibana a partir de uma instância do Elastic Compute Service (ECS) pela internet. |
Se a instância ECS e o cluster ES estiverem em VPCs diferentes, acesse o Kibana pelo endereço IP público da instância ECS. Obtenha o endereço IP público da instância ECS e adicione-o à 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. |
Adicione à lista de permissões de acesso público
Obtain the IP address of your device e adicione-o à lista de permissões de acesso público.
-
Clique em Configure à direita do grupo default. Na caixa de diálogo exibida, adicione os endereços IP à lista de permissões.
Tipo de configuração Formato e exemplo Observações importantes Formato de endereço IPv4
Endereço IP único:
192.168.0.1Bloco CIDR:
192.168.0.0/24. (Recomendado) Consolide endereços IP dispersos em blocos CIDR.
Um único cluster suporta no máximo 300 endereços IP ou blocos CIDR. Separe múltiplos endereços IP ou blocos CIDR com vírgulas (,), sem adicionar 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.Não configure
0.0.0.0/0, pois representa um alto risco de segurança.Alguns clusters e regiões não suportam
0.0.0.0/0. Consulte o console ou a mensagem de erro para obter informações precisas.
Após concluir a configuração, clique em OK.
Clique em Access over Internet. Na página de login do Kibana, insira o nome de usuário e a senha. Após o login bem-sucedido, você acessa o console do Kibana e pode explorar os dados do ES.
Username: fixo como
elastic.Password: a senha definida ao criar o cluster ES. Caso tenha esquecido, você pode reset the password.
Acesse o console Developer Tools e execute o comando
GET /para consultar as informações do cluster. Verificação: se o painel direito retornar um objeto JSON com informações como número de versão e nome do cluster, a conexão foi estabelecida com sucesso.
Etapa 3: Crie um índice
No Kibana Developer Tools, execute uma operação de API RESTful para criar um índice (mapping) chamado product_info para dados de produtos 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 parâmetros principais:
settings: define a configuração de shards do índice. Por exemplo, esta configuração define cinco shards primários e uma réplica para cada shard primário. mappings: define os campos do índice. Por exemplo, esta configuração define três campos: productName, annual_rate e describe. Campos do tipo text suportam tokenização e busca aproximada, enquanto campos do tipo keyword são usados para correspondência exata de valores. Para mais informações sobre tipos de campo, consulte Field data types. Verificação: se a resposta contiver "acknowledged": true e "shards_acknowledged": true, o índice foi criado com sucesso.
Etapa 4: Insira dados
Execute o código a seguir para inserir dados de teste em lote:
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, without any service fee. Minimum investment: 500. Return notifications by SMS."}
Verificação: se a resposta contiver "errors": false, os dados foram inseridos com sucesso.
Etapa 5: Pesquise dados
Busca em índice full-text (correspondência aproximada)
Pesquise os produtos de gestão de patrimônio cujo campo describe contenha "credited returns":
GET /product_info/_search
{
"query": {
"match": {
"describe": "Daily push notifications for credited returns"
}
}
}
Verificação: os resultados são ordenados por pontuação de relevância, com os de maior pontuação aparecendo primeiro.
Busca condicional (correspondência exata)
Pesquise os produtos de gestão de patrimônio cujo annual_rate (taxa de juros anualizada) esteja entre 3,00% e 3,13%:
GET /product_info/_search
{
"query": {
"range": {
"annual_rate": {
"gte": "3.0000%",
"lte": "3.1300%"
}
}
}
}
Verificação: a consulta corresponde exatamente ao intervalo numérico e retorna os resultados que atendem à condição. Para mais informações sobre cláusulas de consulta, consulte Query DSL.
Limpar recursos e próximas etapas
Exclua dados e libere o cluster ES
Execute o código a seguir para excluir o índice de teste criado neste tópico.
DELETE /product_info
A seguinte resposta é retornada:
{
"acknowledged" : true
}
Retorne à lista de clusters no console do Elasticsearch.
Na lista de clusters, localize o cluster que deseja liberar. Na coluna Actions, clique em , selecione Immediately Delete e clique em OK para liberar o cluster. A liberação de um cluster exclui permanentemente o cluster e todos os dados nele contidos. Essa ação é irreversível, portanto prossiga com cautela.
Próximas etapas
Para aprender mais sobre o ES, explore os seguintes tópicos:
Ingestão ou migração de dados: collect or migrate your business data to ES. Antes da migração, avalie o volume de dados para determinar se é necessário ajustar a configuração de upgrade the cluster.
Otimização 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 recursos do Kibana como Discover e Dashboard para criar painéis de visualização de dados.