Daten mit Oracle Cloud Infrastructure Search mit OpenSearch suchen und visualisieren

Einführung

Oracle Cloud Infrastructure (OCI) Search mit OpenSearch ist eine Insight Engine, die als von Oracle verwalteter Service angeboten wird. Mit den Funktionen von OCI für Dashboards OpenSearch und OpenSearch können Sie große Datenmengen schnell speichern, durchsuchen und analysieren und Ergebnisse nahezu in Echtzeit anzeigen. Oracle automatisiert ohne Ausfallzeiten Aktivitäten, die Patching, Update, Upgrade, Backup und Skalierung des Service umfassen.

Ziele

Voraussetzungen für die Erstellung eines Suchclusters verstehen
Erstellen Sie ein OpenSearch-Cluster, stellen Sie eine Verbindung zum Cluster her, und nehmen Sie Daten auf.
Führen Sie Beispielsuchbefehle aus.
Visualisieren Sie Daten in OpenSearch-Dashboards.

Voraussetzungen

Erstellen Sie die erforderlichen Service-Policys in der OCI-Konsole. Ändern Sie any-user in die gewünschte Gruppe, und geben Sie bei Bedarf den Pfad zum Compartment an.

Arbeits-Policys:

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>

Erstellen Sie ein VCN mit einem öffentlichen und einem privaten Subnetz.
- Vereinfachter Prozess:
  1. Gehen Sie zur OCI-Konsole, und öffnen Sie das Navigationsmenü.
  2. Klicken Sie auf Networking und Virtuelle Cloud-Netzwerke.
  3. Klicken Sie auf VCN-Assistenten starten und VCN mit Internetverbindung erstellen.
- Benutzerdefinierter Prozess:
  1. Gehen Sie zur OCI-Konsole, und öffnen Sie das Navigationsmenü.
  2. Klicken Sie auf Networking und Virtuelle Cloud-Netzwerke.
  3. Klicken Sie auf VCN erstellen, und geben Sie Ihre eigenen gewünschten Details ein.
Erstellen Sie eine VM-Instanz im öffentlichen Subnetz des VCN.
1. Gehen Sie zur OCI-Konsole, und öffnen Sie das Navigationsmenü.
2. Klicken Sie auf Compute und Instanzen.
3. Klicken Sie auf Instanz erstellen.
4. Geben Sie den Namen ein, und wählen Sie das Compartment aus.
5. Verwenden Sie im Abschnitt Image und Ausprägung die Standardwerte (Oracle Linux 8, VM.Standard.E4). FlexFeld).
6. Wählen Sie im Abschnitt Networking das öffentliche Subnetz aus, und weisen Sie eine öffentliche IP zu.
7. Legen Sie im Abschnitt SSH-Schlüssel hinzufügen fest, ob Sie einen vorhandenen SSH-Schlüssel verwenden oder einen neuen SSH-Schlüssel generieren möchten. Wenn Sie einen neuen SSH-Schlüssel generieren möchten, müssen Sie den Schlüssel herunterladen.

Hinweis: In diesem Tutorial wurden ein Mac und eine Oracle Linux-Instanz verwendet. Die Anweisungen in der Windows-Befehlszeile können abweichen.

Aufgabe 1: OCI Search Service-Cluster erstellen

Gehen Sie zur OCI-Konsole, navigieren Sie zu Datenbanken, OCI-Suchservice, Cluster, und klicken Sie auf Cluster erstellen. Geben Sie den Clusternamen und das Compartment ein, in dem Sie das Cluster erstellen möchten, und klicken Sie auf Weiter.
Wählen Sie die Clustergröße, und klicken Sie auf Weiter.
Wählen Sie das VCN, das private Subnetz, das im Abschnitt "Voraussetzungen" erstellt wird, und klicken Sie auf Weiter.

Beachten Sie nach der Clustererstellung auf der Detailseite des OCI Search-Serviceclusters die API-Endpunkte und die IP-Adressen, die Sie alternativ verwenden können.

Aufgabe 2: Sicherheitsregeln in der VCN-Sicherheitsliste erstellen

Erstellen Sie im VCN eine Sicherheitsliste mit den folgenden Sicherheitsregeln. Alternativ können sie der VCN-Standardsicherheitsliste hinzugefügt werden.

Klicken Sie auf der Seite Details zum virtuellen Cloud-Netzwerk auf Sicherheitslisten, Sicherheitsliste und Ingress-Regeln hinzufügen.

Hinweis: Fügen Sie eine Regel für Port 9200 (OpenSearch) und eine Regel für 5601 (OpenSearch Dashboards) hinzu.

Aufgabe 3: Verbindung zu OCI Search Service testen - OpenSearch-Endpunkt

Sie können eine der folgenden Optionen verwenden:

Option 1: Von der erstellten VM-Instanz

Melden Sie sich mit SSH bei der Instanz an.

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

Führen Sie einen der folgenden Befehle aus.

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

Oder

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

Option 2: Von Ihrem lokalen Computer über Portweiterleitung

Führen Sie den folgenden Portweiterleitungs-SSH-Befehl im Terminal aus. Schließen Sie das Terminal nicht, um sicherzustellen, dass die Verbindung aktiv bleibt.

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>

Öffnen Sie ein neues Terminalfenster, und führen Sie den folgenden Befehl aus.
```
curl https://localhost:9200 --insecure
```

Wenn die Schritte korrekt ausgeführt werden, sollte eine Antwort wie folgt angezeigt werden, unabhängig von der verwendeten Option.

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

Aufgabe 4: Daten aufnehmen

Führen Sie die folgenden Befehle in Ihrer VM-Instanz aus.

Laden Sie das Beispiel-Dataset herunter.

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

Zuordnung erstellen (optional). Wenn Sie diesen Befehl oder eine Variante davon nicht ausführen, wird automatisch eine Standardzuordnung erstellt.

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

Verschieben Sie das Dataset.

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

Überprüfen Sie Ihre Indizes.

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

Aufgabe 5: OCI Search Service abfragen – Beispielsuchabfrage

Sie können eine der folgenden Optionen verwenden:

Option 1: Aus der VM-Instanz-Shell

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

Option 2: Von Ihrem lokalen Terminal nach der Portweiterleitung

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

Option 3: Von Ihrem lokalen Browser, nach Port-Weiterleitung

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

Weitere Informationen zur Abfragesyntax finden Sie in den Tutorials OpenSearch oder Elasticsearch.

Aufgabe 6: Verbindung zu Dashboards OpenSearch herstellen

Von Ihrem lokalen Rechner über die Portweiterleitung.

Hinweis: Überspringen Sie diesen Schritt, wenn Sie ihn bereits in den vorherigen Schritten ausgeführt haben und die Verbindung noch geöffnet ist.
```
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>
```
Greifen Sie in Ihrem Browser auf https://localhost:5601 zu.

Hinweis: Je nach Browser wird derzeit eine Warnmeldung angezeigt, die Ihre Verbindung ist nicht privat ähnelt. Wählen Sie die Option aus, mit der Sie trotzdem fortfahren können.

Aufgabe 7: Daten in OpenSearch-Dashboards suchen und visualisieren

Greifen Sie bei bestehender Portweiterleitungsverbindung in Ihrem Browser auf https://localhost:5601 zu.
Öffnen Sie das Navigationsmenü OpenSearch "Dashboards".
Navigieren Sie zu Management, Stackmanagement, und klicken Sie auf Indexmuster. Erstellen Sie ein Indexmuster mit dem Namen oci.
Gehen Sie zum Menü OpenSearch "Dashboards", und klicken Sie auf Ermitteln, um Ihre Daten über die Dashboard-UI OpenSearch zu durchsuchen.
Gehen Sie zum Menü OpenSearch Dashboards, klicken Sie auf Dashboards, und führen Sie die folgenden Schritte aus, um ein Beispiel-Tortendiagramm zu erstellen.
1. Klicken Sie auf Neu erstellen, Neue Visualisierung und Kreis.
2. Wählen Sie oci als Quelle aus.
3. Klicken Sie unter Buckets auf Hinzufügen, und blenden Sie Split-Slices ein. Geben Sie die Informationen in der folgenden Abbildung ein, und klicken Sie auf Aktualisieren.

Danksagungen

Autor - Nuno Goncalves (Senior Principal Product Manager)
Mitwirkender – Jordan Oliver (Hauptproduktmanager)

Weitere Lernressourcen

Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie im Oracle Learning YouTube-Channel auf weitere kostenlose Lerninhalte zu. Besuchen Sie außerdem education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Die Produktdokumentation finden Sie im Oracle Help Center.

Titel und Copyright-Informationen

Search and Visualize Data using Oracle Cloud Infrastructure Search with OpenSearch

F70900-03

October 2024

Oracle und/oder verbundene Unternehmen.