Busque y visualice datos mediante Oracle Cloud Infrastructure Search con OpenSearch

Introducción

La búsqueda de Oracle Cloud Infrastructure (OCI) con OpenSearch es un motor de estadísticas que se ofrece como un servicio gestionado por Oracle. Con las capacidades de OCI para los paneles de control OpenSearch y OpenSearch, puede almacenar, buscar y analizar grandes volúmenes de datos rápidamente y ver los resultados casi en tiempo real. Oracle automatiza, sin ningún tiempo de inactividad, actividades que incluyen la aplicación de parches, la actualización, la actualización, la copia de seguridad y el cambio de tamaño del servicio.

Objetivos

Comprenda los requisitos para la creación de un cluster de búsqueda.
Cree un cluster OpenSearch, conéctese al cluster y ingiera datos.
Ejecute comandos de búsqueda de ejemplo.
Visualice los datos en los paneles de control de OpenSearch.

Requisitos

Cree las políticas de servicio necesarias en la consola de OCI. Cambie any-user al grupo deseado y proporcione la ruta de acceso al compartimento si es necesario.

Políticas de trabajo:

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>

Cree una VCN con una subred pública y una subred privada.
- Proceso simplificado:
  1. Vaya a la consola de OCI y abra el menú de navegación.
  2. Haga clic en Red y Red virtual en la nube.
  3. Haga clic en Start VCN Wizard y Create VCN with Internet Connectivity.
- Proceso Personalizado:
  1. Vaya a la consola de OCI y abra el menú de navegación.
  2. Haga clic en Red y Red virtual en la nube.
  3. Haga clic en Create VCN e introduzca los detalles que desee.
Cree una instancia de máquina virtual (VM) en la subred pública de la VCN.
1. Vaya a la consola de OCI y abra el menú de navegación.
2. Haga clic en Recursos informáticos e Instancias.
3. Haga clic en Crear instancia.
4. Introduzca el nombre y el compartimento.
5. En la sección Imagen y unidad, utilice los valores por defecto (Oracle Linux 8, VM.Standard.E4). Flex).
6. En la sección Red, seleccione la subred pública y asigne una IP pública.
7. En la sección Agregar claves SSH, decida si desea utilizar una clave SSH existente o generar una nueva clave SSH. Si selecciona generar una nueva clave SSH, recuerde descargar la clave.

Nota: En este tutorial, se utilizó una instancia de Mac y Oracle Linux. Las instrucciones de la línea de comandos de Windows pueden ser diferentes.

Tarea 1: Creación de un cluster de servicio de búsqueda de OCI

Vaya a la consola de OCI, vaya a Bases de datos, Servicio de búsqueda de OCI, Clusters y haga clic en Crear cluster. Introduzca el nombre y el compartimento del cluster en el que desea crear el cluster y haga clic en Siguiente.
Seleccione el tamaño del cluster y haga clic en Siguiente.
Seleccione la VCN, la subred privada creada en la sección Requisitos y haga clic en Siguiente.

Después de crear el cluster, en la página de detalles del cluster del servicio OCI Search, anote los puntos finales de API y las direcciones IP que puede utilizar de forma alternativa.

Tarea 2: Creación de reglas de seguridad en la lista de seguridad de VCN

En la VCN, cree una lista de seguridad con las siguientes reglas de seguridad. También se pueden agregar a la lista de seguridad por defecto de la VCN.

En la página Detalles de red virtual en la nube, haga clic en Listas de seguridad, Lista de seguridad y Agregar reglas de entrada.

Nota: Agregue una regla para el puerto 9200 (OpenSearch) y una regla para 5601 (paneles de control OpenSearch).

Tarea 3: Prueba de la conexión al servicio OCI Search: punto final OpenSearch

Puede utilizar una de las siguientes opciones.

Opción 1: Desde la instancia de VM creada

Conexión a la instancia mediante SSH.

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

Ejecute uno de los siguientes comandos.

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

O bien:

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

Opción 2: Desde su máquina local, a través del reenvío del puerto

Ejecute el siguiente comando SSH de reenvío de puerto en el terminal. No cierre el terminal para asegurarse de que la conexión permanece activa.

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>

Abra una ventana de terminal nueva y ejecute el comando siguiente.
```
curl https://localhost:9200 --insecure
```

Si los pasos se realizan correctamente, debería ver una respuesta de la siguiente manera, independientemente de la opción utilizada.

{
"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/"
}

Tarea 4: Ingestión de datos

Ejecute los siguientes comandos desde su instancia de VM.

Descargue el juego de datos de muestra.

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

Crear asignación (opcional). Si no ejecuta este comando o cualquier variación del mismo, se creará automáticamente una asignación predeterminada.

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"}
    }
  }
}
'

Envíe el juego de datos.

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

Compruebe sus í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

Tarea 5: Consulta del Servicio OCI Search: Consulta de Ejemplo de Búsqueda

Puede utilizar una de las siguientes opciones.

Opción 1: desde el shell de instancia de 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

Opción 2: Desde su terminal local, después del reenvío del puerto

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

Opción 3: desde el explorador local, después del reenvío del puerto

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

Para obtener más información sobre la sintaxis de consulta, consulte los tutoriales OpenSearch o Elasticsearch.

Tarea 6: Conexión a los paneles de control de OpenSearch

Desde la máquina local, a través del reenvío del puerto.

Nota: Omita este paso si ya lo ha ejecutado en los pasos anteriores y la conexión sigue abierta.

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>

Acceda a https://localhost:5601 en el explorador.

Nota: Actualmente, según el explorador, se muestra un mensaje de advertencia similar a Su conexión no es privada. Seleccione la opción que le permite continuar de todas formas.

Tarea 7: Búsqueda y visualización de datos en paneles de control de OpenSearch

Con la conexión de reenvío del puerto instalada, acceda a https://localhost:5601 en el explorador.
Abra el menú de navegación Paneles de control OpenSearch.
Vaya a Gestión, Gestión de pilas y haga clic en Patrones de índice. Cree un patrón de índice con el nombre oci.
Vaya al menú Paneles de control OpenSearch y haga clic en Detectar para utilizar la interfaz de usuario Paneles de control OpenSearch para buscar los datos.
Vaya al menú Paneles de control OpenSearch, haga clic en Paneles de control y siga estos pasos para crear un gráfico circular de ejemplo.
1. Haga clic en Crear nueva, Nueva visualización y Correr.
2. Seleccione oci como Origen.
3. En Cubos, haga clic en Agregar y amplíe Dividir segmentos. Introduzca la información que se muestra en la siguiente imagen y haga clic en Actualizar.

Agradecimientos

Autor: Nuno Goncalves (director principal sénior de productos)
Contribuyente: Jordan Oliver (mánager principal de productos)

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de formación gratuita en el canal YouTube de Oracle Learning. Además, visita education.oracle.com/learning-explorer para convertirte en un Oracle Learning Explorer.

Para obtener documentación sobre el producto, visite Oracle Help Center.

Título e Información de Copyright

Search and Visualize Data using Oracle Cloud Infrastructure Search with OpenSearch

F70901-03

October 2024

Oracle y/o sus filiales.