Cerca e visualizza i dati utilizzando Oracle Cloud Infrastructure Search con OpenSearch

Introduzione

Oracle Cloud Infrastructure (OCI) Search with OpenSearch è un motore di insight offerto come servizio gestito da Oracle. Grazie alle funzionalità di OCI per i dashboard OpenSearch e OpenSearch, puoi memorizzare, cercare e analizzare rapidamente grandi volumi di dati e vedere i risultati quasi in tempo reale. Oracle automatizza, senza tempi di inattività, attività che includono l'applicazione di patch, l'aggiornamento, l'upgrade, il backup e il ridimensionamento del servizio.

Obiettivi

Comprendere i prerequisiti per la creazione di un cluster di ricerca.
Creare un cluster OpenSearch, connettersi al cluster e includere dati.
Eseguire comandi di ricerca di esempio.
Visualizzare i dati nei dashboard OpenSearch.

Prerequisiti

Creare i criteri di servizio necessari in OCI Console. Modificare any-user nel gruppo desiderato e fornire il percorso al compartimento, se necessario.

Criteri di lavoro:

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>

Crea una VCN con una subnet pubblica e una subnet privata.
- Processo semplificato:
  1. Andare a OCI Console e aprire il menu di navigazione.
  2. Fare clic su Networking e Reti cloud virtuali.
  3. Fare clic su Avvia procedura guidata VCN e su Crea VCN con connettività Internet.
- Processo personalizzato:
  1. Andare a OCI Console e aprire il menu di navigazione.
  2. Fare clic su Networking e Reti cloud virtuali.
  3. Fare clic su Crea VCN e immettere i dettagli desiderati.
Crea un'istanza di virtual machine (VM) nella subnet pubblica della VCN.
1. Andare a OCI Console e aprire il menu di navigazione.
2. Fare clic su Computazione e Istanze.
3. Fare clic su Crea istanza.
4. Immettere il nome e selezionare il compartimento.
5. Nella sezione Immagine e forma, utilizzare i valori predefiniti (Oracle Linux 8, VM.Standard.E4). Flex).
6. Nella sezione Networking selezionare la subnet pubblica e assegnare un IP pubblico.
7. Nella sezione Aggiungi chiavi SSH, decidere se utilizzare una chiave SSH esistente o generare una nuova chiave SSH. Se si sceglie di generare una nuova chiave SSH, ricordarsi di scaricare la chiave.

Nota: in questa esercitazione sono stati utilizzati un Mac e un'istanza di Oracle Linux. Le istruzioni della riga di comando di Windows potrebbero differire.

Task 1: creare un cluster di servizi di ricerca OCI

Andare alla console OCI, andare a Database, Servizio di ricerca OCI, Cluster e fare clic su Crea cluster. Immettere il nome e il compartimento del cluster in cui si desidera creare il cluster e fare clic su Successivo.
Selezionare la dimensione del cluster e fare clic su Successivo.
Selezionare la VCN, creare la subnet privata nella sezione Prerequisiti e fare clic su Avanti.

Dopo la creazione del cluster, nella pagina dei dettagli del cluster del servizio OCI Search prendere nota degli endpoint API e degli indirizzi IP che è possibile utilizzare in alternativa.

Task 2: creare regole di sicurezza nella lista di sicurezza VCN

Nella VCN creare una lista di sicurezza con le regole di sicurezza riportate di seguito. In alternativa, possono essere aggiunti all'elenco di sicurezza predefinito della VCN.

Nella pagina Dettagli rete cloud virtuale fare clic su Elenchi di sicurezza, Elenco di sicurezza e Aggiungi regole di entrata.

Nota: aggiungere una regola per la porta 9200 (OpenSearch) e una regola per i dashboard 5601 (OpenSearch).

Task 3: eseguire il test della connessione al servizio di ricerca OCI - Endpoint OpenSearch

È possibile utilizzare una delle seguenti opzioni.

Opzione 1: dall'interno dell'istanza VM creata

Connettersi all'istanza utilizzando la shell SSH.

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

Eseguire uno dei comandi sotto riportati.

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

Oppure

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

Opzione 2: Dalla tua macchina locale, attraverso il port forwarding

Eseguire il seguente comando SSH di inoltro della porta nel terminale. Non chiudere il terminale per accertarsi che la connessione rimanga attiva.

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>

Aprire una nuova finestra del terminale ed eseguire il comando seguente.
```
curl https://localhost:9200 --insecure
```

Se i passaggi vengono eseguiti correttamente, si dovrebbe vedere una risposta come segue, indipendentemente dall'opzione utilizzata.

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

Task 4: Includi dati

Eseguire i comandi riportati di seguito dall'istanza VM.

Scaricare il set di dati di esempio.

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

Creare un mapping (facoltativo). Se non si esegue questo comando o qualsiasi variazione di esso, verrà creato automaticamente un mapping predefinito.

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

Eseguire il push del data set.

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

Controlla i tuoi indici.

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

Task 5: Query sul servizio di ricerca OCI - Query di ricerca di esempio

È possibile utilizzare una delle seguenti opzioni.

Opzione 1: dalla shell dell'istanza 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

Opzione 2: Dal tuo terminale locale, dopo l'inoltro della porta

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

Opzione 3: dal browser locale, dopo l'inoltro della porta

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

Per ulteriori informazioni sulla sintassi delle query, vedere le esercitazioni OpenSearch o Elasticsearch.

Task 6: connettersi ai dashboard OpenSearch

Dalla tua macchina locale, attraverso l'inoltro della porta.

Nota: ignorare questo passo se è già stato eseguito nei passi precedenti e la connessione è ancora aperta.

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>

Accedi a https://localhost:5601 nel tuo browser.

Nota: attualmente, a seconda del browser, viene visualizzato un messaggio di avvertenza simile a La connessione non è privata. Selezionare l'opzione che consente di procedere comunque.

Task 7: cercare e visualizzare i dati nei dashboard OpenSearch

Con la connessione di inoltro della porta in posizione, accedere a https://localhost:5601 nel browser.
Aprire il menu di navigazione OpenSearch Dashboard.
Passare a Gestione, Gestione stack e fare clic su Pattern di indici. Creare un pattern di indice denominato oci.
Andare al menu OpenSearch Dashboard e fare clic su Trova per utilizzare l'interfaccia utente dei dashboard OpenSearch per cercare i dati.
Andare al menu OpenSearch Dashboard, fare clic su Dashboard e attenersi alla procedura riportata di seguito per creare un grafico a torta di esempio.
1. Fare clic su Crea nuova, Nuova visualizzazione e A torta.
2. Selezionare oci come Origine.
3. In Bucket, fare clic su Aggiungi ed espandere Dividi slice. Immettere le informazioni visualizzate nella seguente immagine e fare clic su Aggiorna.

Conferme

Autore - Nuno Goncalves (Senior Principal Product Manager)
Contributor - Jordan Oliver (Principal Product Manager)

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti gratuiti sulla formazione su Oracle Learning YouTube channel. Inoltre, visita education.oracle.com/learning-explorer per diventare un Oracle Learning Explorer.

Per la documentazione del prodotto, visita l'Oracle Help Center.

Titolo e informazioni sul copyright

Search and Visualize Data using Oracle Cloud Infrastructure Search with OpenSearch

F70903-03

October 2024

Oracle e/o relative consociate.