Pesquise e Visualize Dados usando o Oracle Cloud Infrastructure Search com OpenSearch

Introdução

O Oracle Cloud Infrastructure (OCI) Search with OpenSearch é um mecanismo de insight oferecido como um serviço gerenciado pela Oracle. Com os recursos da OCI para Painéis OpenSearch e OpenSearch, você pode armazenar, pesquisar e analisar grandes volumes de dados rapidamente e ver os resultados quase em tempo real. A Oracle automatiza, sem tempo de inatividade, atividades que incluem aplicação de patches, atualização, atualização, backup e redimensionamento do serviço.

Objetivos

• Entenda os pré-requisitos para a criação de um cluster de pesquisa.

• Crie um cluster OpenSearch, conecte-se ao cluster e ingira dados.

• Execute comandos de pesquisa de amostra.

• Visualize dados em painéis de controle OpenSearch.

Pré-requisitos

1. Crie as políticas de serviço necessárias na Console do OCI. Altere any-user para o grupo desejado e forneça o caminho para o compartimento, se necessário.

   Políticas de trabalho:

   Allow group SearchOpenSearchAdmins to manage vnics in compartment <NETWORK_RESOURCES_COMPARTMENT>
   Allow group SearchOpenSearchAdmins to manage vcns in compartment <NETWORK_RESOURCES_COMPARTMENT>
   Allow group SearchOpenSearchAdmins to manage subnets in compartment <NETWORK_RESOURCES_COMPARTMENT>
   Allow group SearchOpenSearchAdmins to use network-security-groups in compartment <NETWORK_RESOURCES_COMPARTMENT>
   Allow group SearchOpenSearchAdmins to manage opensearch-family in compartment <CLUSTER_RESOURCES_COMPARTMENT>
   

2. Crie uma VCN com uma sub-rede pública e uma sub-rede privada.

   • Processo Simplificado:

     1. Vá para a Console do OCI e abra o menu de navegação.

     2. Clique em Rede e Redes Virtuais na Nuvem.

     3. Clique em Start VCN Wizard e em Create VCN with Internet Connectivity.

   • Processo Personalizado:

     1. Vá para a Console do OCI e abra o menu de navegação.

     2. Clique em Rede e Redes Virtuais na Nuvem.

     3. Clique em Criar VCN e informe seus próprios detalhes desejados.

3. Crie uma instância de máquina virtual (VM) na sub-rede pública da VCN.

   1. Vá para a Console do OCI e abra o menu de navegação.

   2. Clique em Compute e Instâncias.

   3. Clique em Criar instância.

   4. Digite o Nome e selecione o compartimento.

   5. Na seção Imagem e forma, use os valores padrão (Oracle Linux 8, VM.Standard.E4. Flex).

   6. Na seção Rede, selecione a sub-rede pública e designe um IP público.

   7. Na seção Adicionar chaves SSH, decida se deseja usar uma chave SSH existente ou gerar uma nova chave SSH. Se você optar por gerar uma nova chave SSH, lembre-se de fazer download da chave.

Observação: Neste tutorial, uma instância do Mac e do Oracle Linux foi usada. As instruções da linha de comando do Windows podem ser diferentes.

Tarefa 1: Criar um Cluster de Serviços do OCI Search

1. Vá para a Console do OCI, navegue até Bancos de Dados, OCI Search Service, Clusters e clique em Criar cluster. Informe o nome e o compartimento do cluster no qual você deseja criar o cluster e clique em Próximo.

   

2. Selecione o tamanho do cluster e clique em Próximo.

   

3. Selecione a VCN, a sub-rede privada criada na seção Pré-requisitos e clique em Próximo.

   

   Após a criação do cluster, na página de detalhes do cluster do serviço OCI Search, anote os pontos finais da API e os endereços IP que você pode usar como alternativa.

   

Tarefa 2: Criar Regras de Segurança na Lista de Segurança da VCN

Na VCN, crie uma lista de segurança com as regras de segurança a seguir. Como alternativa, eles podem ser adicionados à lista de segurança padrão da VCN.

1. Na página Detalhes da rede virtual na nuvem, clique em Listas de Segurança, Lista de Segurança e Adicionar Regras de Entrada.

   Observação: Adicione uma regra para a porta 9200 (OpenSearch) e uma regra para 5601 (OpenSearch Dashboards).

   

   

   

Tarefa 3: Testar a Conexão com o OCI Search Service – Ponto Final OpenSearch

Você pode usar uma das opções a seguir.

Opção 1: Na Instância da VM Criada

1. Conecte-se à instância usando SSH.

   ssh -i ~/.ssh/id_rsa_opensearch.key opc@<your_VM_instance_public_IP>
   

2. Execute um dos comandos a seguir.

   curl https://mycluster.opensearch.us.example.com:9200
   # OpenSearch API endpoint example
   

   Ou

   curl https://<your_opensearch_private_IP>:9200 --insecure
   # OpenSearch private IP example
   

Opção 2: Da sua Máquina Local, através do Encaminhamento de Portas

1. Execute o comando SSH de encaminhamento de porta a seguir no terminal. Não feche o terminal para garantir que a conexão permaneça ativa.

   ssh -C -v -t -L 127.0.0.1:5601:<your_opensearch_dashboards_private_IP>:5601 -L 127.0.0.1:9200:<your_opensearch_private_IP>:9200 opc@<your_VM_instance_public_IP> -i <path_to_your_private_key>
   

2. Abra uma nova janela de terminal e execute o seguinte comando.

   curl https://localhost:9200 --insecure
   

Se as etapas forem executadas corretamente, você verá uma resposta da seguinte forma, independentemente da opção usada.

{
"name" : "opensearch-master-0",
"cluster_name" : "opensearch",
"cluster_uuid" : "M6gclrE3QLGEBlkdme8JkQ",
"version" : {
   "distribution" : "opensearch",
   "number" : "1.2.4-SNAPSHOT",
   "build_type" : "tar",
   "build_hash" : "e505b10357c03ae8d26d675172402f2f2144ef0f",
   "build_date" : "2022-02-08T16:44:39.596468Z",
   "build_snapshot" : true,
   "lucene_version" : "8.10.1",
   "minimum_wire_compatibility_version" : "6.8.0",
   "minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "The OpenSearch Project: https://opensearch.org/"
}

Tarefa 4: Ingerir Dados

Execute os comandos a seguir na sua instância de VM.

1. Faça download do conjunto de dados de amostra.

   curl -O https://raw.githubusercontent.com/oracle-livelabs/oci/main/oci-opensearch/files/OCI_services.json
   

2. Crie o mapeamento (opcional). Se você não executar este comando ou qualquer variação dele, um mapeamento padrão será criado automaticamente.

   curl -XPUT "https://mycluster.opensearch.us.example.com:9200/oci" -H 'Content-Type: application/json' -d'
   {
     "mappings": {
       "properties": {
       "id": {"type": "integer"},
       "category": {"type": "keyword"},
      "text": {"type": "text"},
      "title": {"type": "text"},
      "url": {"type": "text"}
       }
     }
   }
   '
   

3. Envie o conjunto de dados.

   curl -H 'Content-Type: application/x-ndjson' -XPOST "https://<your_opensearch_private_IP>:9200/oci/_bulk?pretty" --data-binary @OCI_services.json
   

4. Verifique seus índices.

   curl "https://mycluster.opensearch.us.example.com:9200/_cat/indices"
   # OpenSearch API endpoint example
   

   curl -X GET "https://<your_opensearch_private_IP>:9200/_cat/indices" --insecure
   # OpenSearch private IP example
   

Tarefa 5: Consultar o OCI Search Service – Consulta de Pesquisa de Amostra

Você pode usar uma das opções a seguir.

Opção 1: No Shell da Instância da VM

curl -X GET "https://mycluster.opensearch.us.example.com:9200/oci/_search?q=title:Kubernetes&pretty"
# OpenSearch API endpoint example

curl -X GET "https://<your_opensearch_private_IP>:9200/oci/_search?q=title:Kubernetes&pretty"
# OpenSearch private IP example

Opção 2: Do seu terminal local, após o encaminhamento da porta

curl -X GET "https://localhost:9200/oci/_search?q=title:Kubernetes&pretty" --insecure

Opção 3: Do seu navegador local, após o encaminhamento de porta

https://localhost:9200/oci/_search?q=title:Kubernetes&pretty

Para obter mais informações sobre sintaxe de consulta, consulte os tutoriais OpenSearch ou Elasticsearch.

Tarefa 6: Conectar-se aos Painéis de Controle OpenSearch

1. Da sua máquina local, através do encaminhamento de porta.

   Observação: ignore esta etapa se você já a tiver executado nas etapas anteriores e a conexão ainda estiver aberta.

   ssh -C -v -t -L 127.0.0.1:5601:<your_opensearch_dashboards_private_IP>:5601 -L 127.0.0.1:9200:<your_opensearch_private_IP>:9200 opc@<your_instance_public_ip> -i <path_to_your_private_key>
   

2. Acesse https://localhost:5601 no seu browser.

   Observação: No momento, dependendo do browser, uma mensagem de advertência semelhante a Sua conexão não é privada é exibida. Selecione a opção que permite continuar mesmo assim.

   

Tarefa 7: Pesquisar e Visualizar Dados nos Painéis de Controle OpenSearch

1. Com a conexão de encaminhamento de porta em vigor, acesse https://localhost:5601 no seu browser.

2. Abra o menu de navegação OpenSearch Dashboards.

3. Navegue até Gerenciamento, Gerenciamento de Pilha e clique em Padrões de Índice. Crie um padrão de índice com o nome oci.

   

4. Vá para o menu Painéis de Controle OpenSearch e clique em Descobrir para usar a UI Painéis de Controle OpenSearch para pesquisar seus dados.

   

5. Vá para o menu Painéis de Controle OpenSearch, clique em Painéis de Controle e siga estas etapas para criar um gráfico de pizza de amostra.

   1. Clique em Criar nova, Nova Visualização e Pizza.

      

   2. Selecione oci como Origem.

   3. Em Buckets, clique em Adicionar e expanda Dividir segmentos. Especifique as informações mostradas na imagem a seguir e clique em Atualizar.

      

Links Relacionados

• Oracle Cloud Infrastructure Search com OpenSearch

• Agregue logs usando o OCI Search Service com OpenSearch

• Usar o OCI Search Service com OpenSearch para criar uma pesquisa no aplicativo

Confirmações

• Autor - Nuno Goncalves (Gerente Sênior de Produtos)

• Colaborador - Jordan Oliver (Gerente de Produtos Principal)

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal Oracle Learning YouTube. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.

---

Título e Informações de Copyright

Search and Visualize Data using Oracle Cloud Infrastructure Search with OpenSearch

F70908-03

October 2024

Copyright ©2024,

Oracle e/ou suas empresas afiliadas.