Tutorial: Erste Schritte mit Amazon OpenSearch Serverless - OpenSearch Amazon-Dienst
Schritt 1: Konfigurieren von BerechtigungenSchritt 2: Erstellen einer SammlungSchritt 3: Daten hochladen und suchenSchritt 4: Sammlung löschenNächste Schritte

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Tutorial: Erste Schritte mit Amazon OpenSearch Serverless

Dieses Tutorial führt Sie durch die grundlegenden Schritte, um eine Amazon OpenSearch Serverless Search Sammlung schnell auszuführen. Eine Suchsammlung ermöglicht es Ihnen, Anwendungen in Ihren internen Netzwerken und Anwendungen mit Internetzugriff zu unterstützen, z. B. die Suche auf E-Commerce-Websites und Inhaltssuche.

Informationen zur Verwendung einer Vektorsuchsammlung finden Sie unter. Arbeiten mit Vektorsuchsammlungen Ausführlichere Informationen zur Verwendung von Sammlungen finden Sie unter Verwaltung von Amazon OpenSearch Serverless-Sammlungen und den anderen Themen in diesem Handbuch.

In diesem Tutorial führen Sie die folgenden Schritte durch:

  1. Konfigurieren von Berechtigungen

  2. Erstellen einer Sammlung

  3. Hochladen und Suchen von Daten

  4. Löschen der Sammlung

    Anmerkung

    Wir empfehlen, nur ASCII-Zeichen für Ihre zu verwenden. IndexName Wenn Sie für Ihre keine ASCII-Zeichen verwendenIndexName, werden die eingegebenen CloudWatch Messwerte IndexName in ein URL-codiertes Format für Nicht-ASCII-Zeichen konvertiert.

Schritt 1: Konfigurieren von Berechtigungen

Um dieses Tutorial und OpenSearch Serverless im Allgemeinen verwenden zu können, müssen Sie über die richtigen IAM-Berechtigungen verfügen. In diesem Tutorial werden Sie eine Sammlung erstellen, Daten hochladen und suchen und die Sammlung anschließend löschen.

Ihr Benutzer oder Ihre Rolle muss über eine angefügte identitätsbasierte Richtlinie mit den folgenden Mindestberechtigungen verfügen:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "aoss:CreateCollection",
        "aoss:ListCollections",
        "aoss:BatchGetCollection",
        "aoss:DeleteCollection",
        "aoss:CreateAccessPolicy",
        "aoss:ListAccessPolicies",
        "aoss:UpdateAccessPolicy",
        "aoss:CreateSecurityPolicy",
        "aoss:GetSecurityPolicy",
        "aoss:UpdateSecurityPolicy",
        "iam:ListUsers",
        "iam:ListRoles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Weitere Informationen zu IAM-Berechtigungen für OpenSearch Serverless finden Sie unter. Identity and Access Management für Amazon OpenSearch Serverless

Schritt 2: Erstellen einer Sammlung

Eine Sammlung ist eine Gruppe von OpenSearch Indizes, die zusammenarbeiten, um einen bestimmten Workload oder Anwendungsfall zu unterstützen.

So erstellen Sie eine OpenSearch Serverless-Sammlung

  1. Öffnen Sie die Amazon OpenSearch Service-Konsole zu https://console.aws.amazon.com/aos/Hause.

  2. Wählen Sie im linken Navigationsbereich Collections (Sammlungen) und wählen Sie Create collection (Sammlung erstellen) aus.

  3. Benennen Sie die Sammlung movies (Filme).

  4. Wählen Sie für den Sammlungstyp Search (Suche) aus. Weitere Informationen finden Sie unter Auswahl eines Sammlungstyps.

  5. Wählen Sie unter Sicherheit die Option Standard Create aus.

  6. Wählen Sie unter Verschlüsselung die Option Verwenden aus AWS-eigener Schlüssel. Dies ist der AWS KMS key , den OpenSearch Serverless zur Verschlüsselung Ihrer Daten verwendet.

  7. Konfigurieren Sie unter Network (Netzwerk) die Netzwerkeinstellungen für die Sammlung.

    • Wählen Sie für den Zugriffstyp Public (Öffentlich) aus.

    • Wählen Sie als Ressourcentyp sowohl Zugriff auf OpenSearch Endpunkte aktivieren als auch Zugriff auf Dashboards aktivieren aus. OpenSearch Da Sie Daten mithilfe von OpenSearch Dashboards hochladen und suchen, müssen Sie beides aktivieren.

  8. Wählen Sie Weiter aus.

  9. Richten Sie unter Configure data access (Datenzugriff konfigurieren) die Zugriffseinstellungen für die Sammlung ein. Datenzugriffsrichtlinien ermöglichen Benutzern und Rollen den Zugriff auf die Daten innerhalb einer Sammlung. In diesem Tutorial erteilen wir einem einzelnen Benutzer die Berechtigungen, die zum Indizieren und Durchsuchen von Daten in der Filme-Sammlung erforderlich sind.

    Erstellen Sie eine einzelne Regel, die den Zugriff auf die Filme-Sammlung ermöglicht. Nennen Sie die Regel Movies collection access (Zugriff auf Filme-Sammlung).

  10. Wählen Sie Add principals (Prinzipale hinzufügen), IAM users and roles (IAM-Benutzer und -Rollen) und wählen Sie den Benutzer oder die Rolle aus, den/die Sie für die Anmeldung bei OpenSearch Dashboards und die Indizierung von Daten verwenden werden. Wählen Sie Speichern.

  11. Wählen Sie unter Index permissions (Indexberechtigungen) alle Berechtigungen aus.

  12. Wählen Sie Weiter aus.

  13. Wählen Sie für die Zugriffsrichtlinieneinstellungen die Option Create a new data access policy (Neue Datenzugriffsrichtlinie erstellen) aus und nennen Sie die Richtlinie movies (Filme).

  14. Wählen Sie Weiter aus.

  15. Überprüfen Sie Ihre Sammlungseinstellungen und wählen Sie Submit (Senden) aus. Warten Sie einige Minuten, bis der Sammlungsstatus Active erreicht ist.

Schritt 3: Daten hochladen und suchen

Sie können Daten mit Postman oder cURL OpenSearch in eine Serverless-Sammlung hochladen. Der Kürze halber verwenden diese Beispiele Dev Tools innerhalb der OpenSearch Dashboards-Konsole.

So indizieren und durchsuchen Sie Daten in der Filme-Sammlung

  1. Wählen Sie im linken Navigationsbereich Collections (Sammlungen) und wählen Sie die movies (Filme)-Sammlung aus, um ihre Detailseite zu öffnen.

  2. Wählen Sie die OpenSearch Dashboards-URL für die Sammlung aus. Die URL nimmt das Format https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id} an.

  3. Öffnen Sie in OpenSearch Dashboards den linken Navigationsbereich und wählen Sie Dev Tools (Entwickler-Tools).

  4. Um einen einzelnen Index mit dem Namen movies-index zu erstellen, senden Sie die folgende Anfrage:

    PUT movies-index
    OpenSearch Dashboards console showing PUT request for movies-index with JSON response.

  5. Um ein einzelnes Dokument in movies-index zu indizieren, senden Sie die folgende Anfrage:

    PUT movies-index/_doc/1
{ 
  "title": "Shawshank Redemption",
  "genre": "Drama",
  "year": 1994
}

  6. Um Daten in OpenSearch Dashboards zu suchen, müssen Sie mindestens ein Indexmuster konfigurieren. OpenSearch verwendet diese Muster, um festzustellen, welche Indizes Sie analysieren möchten. Öffnen Sie den linken Navigationsbereich, wählen Sie Stack-Verwaltung, wählen Sie Indexmuster und anschließend die Option Indexmuster erstellen aus. Geben Sie für dieses Tutorial Filme ein.

  7. Wählen Sie Nächster Schritt aus und klicken Sie auf Indexmuster erstellen. Nachdem das Muster erstellt wurde, können Sie die verschiedenen Dokumentfelder anzeigen, z. B. title und genre.

  8. Um mit der Suche nach Ihren Daten zu beginnen, öffnen Sie erneut den linken Navigationsbereich und wählen Sie Discover (Entdecken) aus, oder verwenden Sie die Such-API in Dev Tools.

Schritt 4: Sammlung löschen

Da die Filme-Sammlung zu Testzwecken dient, sollten Sie sie löschen, wenn Sie mit dem Experimentieren fertig sind.

So erstellen Sie eine OpenSearch Serverless-Sammlung

  1. Gehen Sie zurück zur Amazon OpenSearch Service-Konsole.

  2. Wählen Sie im linken Navigationsbereich Collections (Sammlungen) und anschließend die movies (Filme)-Samlung aus.

  3. Wählen Sie Löschen und bestätigen Sie das Löschen.

Nächste Schritte

Da Sie nun wissen, wie Sie eine Sammlung erstellen und Daten indizieren, möchten Sie vielleicht einige der folgenden Übungen ausprobieren: