View a markdown version of this page

Tutorial: Erste Schritte mit Amazon OpenSearch Serverless - OpenSearch Amazon-Dienst
Schritt 1: Konfigurieren von BerechtigungenSchritt 2: Erstellen einer SammlungSchritt 3: Daten hochladen und suchenFehlerbehandlungSchritt 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 zeigt Ihnen die grundlegenden Schritte, um eine Amazon OpenSearch Serverless-Suchsammlung schnell zum Laufen zu bringen. Mit einer Suchsammlung können Sie Anwendungen in Ihren internen Netzwerken und Internetanwendungen wie die Suche nach E-Commerce-Websites und die Inhaltssuche unterstützen.

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

    Verwenden Sie für Ihre nur ASCII-Zeichen. IndexName Wenn Sie keine ASCII-Zeichen für Ihre verwendenIndexName, werden die CloudWatch In-Metriken IndexName in ein URL-kodiertes Format für Nicht-ASCII-Zeichen konvertiert.

Schritt 1: Konfigurieren von Berechtigungen

Um dieses Tutorial abzuschließen und OpenSearch Serverless im Allgemeinen verwenden zu können, müssen Sie über die richtigen IAM-Berechtigungen verfügen. In diesem Tutorial erstellen Sie eine Sammlung, laden Daten hoch und suchen sie und löschen dann die Sammlung.

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

JSON
{
  "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 OpenSearch serverlosen IAM-Berechtigungen 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 eine bestimmte Arbeitslast oder einen bestimmten Anwendungsfall zu unterstützen.

Um eine OpenSearch serverlose Sammlung zu erstellen

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

  2. Wählen Sie im linken Navigationsbereich Sammlungen aus.

  3. Wählen Sie Create Connection (Verbindung erstellen) aus.

  4. Geben Sie unter Name movies ein.

  5. Wählen Sie als Sammlungstyp die Option Suchen aus. Weitere Informationen finden Sie unter Auswahl eines Sammlungstyps.

  6. Wählen Sie als Methode zur Sammlungserstellung die Option Express Create aus.

  7. Überprüfen Sie die Standardeinstellungen. Dazu gehören die Sammlungsgruppe, OpenSearch UI-Anwendungseinstellungen, Verschlüsselung mit einem AWS-eigener Schlüssel, öffentlicher Netzwerkzugriff und die automatisch generierte Datenzugriffsrichtlinie.

  8. Wählen Sie Create Connection (Verbindung erstellen) aus.

  9. Warten Sie, bis sich der Status der Sammlung auf Active ändert. Dies kann einige Minuten dauern.

Tipp

In diesem Tutorial wird die NextGen Express Create-Methode verwendet. Sie können Express Create auch über die Schaltfläche Express Create im Infobanner auf der Landingpage aufrufen, um den Vorgang zu beschleunigen. Verwenden Sie Standard Create, um mehr Kontrolle über die Einstellungen für Verschlüsselung, Netzwerk und Datenzugriff zu erhalten. Um den Classic-Assistenten zum Erstellen von Sammlungen zu verwenden, wählen Sie Zu Classic wechseln. Weitere Informationen finden Sie unter Erstellen von Sammlungen.

Schritt 3: Daten hochladen und suchen

Sie können Daten mit Postman oder cURL in eine OpenSearch serverlose Sammlung hochladen. Der Einfachheit halber verwenden diese Beispiele Dev Tools in 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 Dashboard-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 aus.

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

    PUT movies-index
    OpenSearch Die Dashboard-Konsole zeigt die PUT-Anfrage zum Filmindex mit dem Antwortstatus 200 an.

  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 zu identifizieren, 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 aus, oder verwenden Sie die Such-API in Dev Tools.

Fehlerbehandlung

Wenn Sie Index- und Suchvorgänge ausführen, erhalten Sie möglicherweise die folgenden Fehlerantworten:

  • HTTP 507— Zeigt an, dass ein interner Serverfehler aufgetreten ist. Dieser Fehler weist im Allgemeinen darauf hin, dass Ihre OpenSearch Recheneinheiten (OCUs) durch das Volumen oder die Komplexität Ihrer Anfragen überlastet sind. OpenSearch Serverless skaliert zwar automatisch, um die Last zu verwalten, es kann jedoch zu Verzögerungen bei der Bereitstellung zusätzlicher Ressourcen kommen.

    Um diesen Fehler zu beheben, implementieren Sie eine exponentielle Backoff-Wiederholungsrichtlinie. Dieser Ansatz reduziert vorübergehend die Anforderungsrate, um die Last effektiv zu verwalten. Weitere Informationen finden Sie unter Verhalten bei Wiederholungsversuchen im Referenzhandbuch für AWS SDKs und Tools.

  • HTTP 402— Zeigt an, dass Sie das Kapazitätslimit für die maximale OpenSearch Recheneinheit (OCU) erreicht haben. Optimieren Sie Ihren Workload, um die OCU-Nutzung zu reduzieren, oder fordern Sie eine Erhöhung des Kontingents an.

Schritt 4: Sammlung löschen

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

Um eine OpenSearch serverlose Sammlung zu löschen

  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

Nachdem Sie nun wissen, wie Sie eine Sammlung erstellen und Daten indexieren, möchten Sie vielleicht Folgendes ausprobieren: