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-Suchsammlung* schnell zum Laufen zu bringen. Eine Suchsammlung ermöglicht es Ihnen, Anwendungen in Ihren internen Netzwerken und mit dem Internet verbundene Anwendungen wie die Suche nach E-Commerce-Websites und die Inhaltssuche zu unterstützen. Informationen zur Verwendung einer *Vektorsuchsammlung* finden Sie unter. [Arbeiten mit Vektorsuchsammlungen](serverless-vector-search.md) Ausführlichere Informationen zur Verwendung von Sammlungen finden Sie unter [Verwaltung von Amazon OpenSearch Serverless-Sammlungen](serverless-manage.md) und den anderen Themen in diesem Handbuch. In diesem Tutorial führen Sie die folgenden Schritte durch: 1. [Konfigurieren von Berechtigungen](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions) 1. [Erstellen einer Sammlung](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create) 1. [Hochladen und Suchen von Daten](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index) 1. [Löschen der Sammlung](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete) **Anmerkung** Wir empfehlen, dass Sie für Ihre nur ASCII-Zeichen verwenden. `IndexName` Wenn Sie für Ihre keine ASCII-Zeichen verwenden`IndexName`, 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 abzuschließen 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](security-iam-serverless.md#security-iam-serverless-id-based-policies) 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 Serverless IAM-Berechtigungen finden Sie unter. [Identity and Access Management für Amazon OpenSearch Serverless](security-iam-serverless.md) ## 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 zu [https://console.aws.amazon.com/aos/Hause](https://console.aws.amazon.com/aos/home ). 1. Wählen Sie im linken Navigationsbereich **Collections** (Sammlungen) und wählen Sie **Create collection** (Sammlung erstellen) aus. 1. Benennen Sie die Sammlung **movies** (Filme). 1. Wählen Sie für den Sammlungstyp **Search** (Suche) aus. Weitere Informationen finden Sie unter [Auswahl eines Sammlungstyps](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase). 1. Wählen Sie **unter Sicherheit** die Option **Standard create** aus. 1. Wählen Sie unter **Verschlüsselung** die Option **Verwenden** aus AWS-eigener Schlüssel. Dies ist der AWS KMS key , den OpenSearch Serverless verwendet, um Ihre Daten zu verschlüsseln. 1. 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 beide aktivieren. 1. Wählen Sie **Weiter** aus. 1. Richten Sie unter **Configure data access** (Datenzugriff konfigurieren) die Zugriffseinstellungen für die Sammlung ein. [Datenzugriffsrichtlinien](serverless-data-access.md) 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). 1. Wählen Sie **Principals, IAM-Benutzer und -Rollen hinzufügen** **und** wählen Sie den Benutzer oder die Rolle aus, mit der Sie sich bei OpenSearch Dashboards anmelden und Daten indexieren möchten. Wählen Sie **Speichern**. 1. Wählen Sie unter **Index permissions** (Indexberechtigungen) alle Berechtigungen aus. 1. Wählen Sie **Weiter** aus. 1. 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). 1. Wählen Sie **Weiter** aus. 1. Ü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](https://www.postman.com/downloads/) oder cURL in eine OpenSearch serverlose Sammlung hochladen. Der Kürze halber verwenden diese Beispiele **Dev Tools** in der Dashboards-Konsole. OpenSearch **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. 1. 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. 1. Öffnen Sie in OpenSearch Dashboards den linken Navigationsbereich und wählen Sie **Dev** Tools aus. 1. 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.\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/images/serverless-gsg-create.png) 1. 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 } ``` 1. 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. 1. 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`. 1. 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](https://opensearch.org/docs/latest/api-reference/search/) in Dev Tools. ## Fehlerbehandlung Beim Ausführen von Index- und Suchvorgängen 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](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) im Referenzhandbuch *AWS SDKs und im Tools-Referenzhandbuch.* + `HTTP 402`— Zeigt an, dass Sie die maximale Kapazitätsgrenze für OpenSearch Recheneinheiten (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 *Filme*-Sammlung 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**. 1. Wählen Sie im linken Navigationsbereich **Collections** (Sammlungen) und anschließend die **movies** (Filme)-Samlung aus. 1. 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: + Weitere erweiterte Optionen zum Erstellen einer Sammlung finden Sie hier. Weitere Informationen finden Sie unter [Verwaltung von Amazon OpenSearch Serverless-Sammlungen](serverless-manage.md). + Erfahren Sie, wie Sie Sicherheitsrichtlinien konfigurieren, um die Sammlungssicherheit in großem Umfang zu verwalten. Weitere Informationen finden Sie unter [Überblick über die Sicherheit in Amazon OpenSearch Serverless](serverless-security.md). + Entdecken Sie andere Möglichkeiten, Daten in Sammlungen zu indizieren. Weitere Informationen finden Sie unter [Daten in Amazon OpenSearch Serverless-Sammlungen aufnehmen](serverless-clients.md).