View a markdown version of this page

Tutoriel : Démarrage avec Amazon OpenSearch Serverless - Amazon OpenSearch Service
Étape 1 : configurer des autorisationsÉtape 2 : créer une collectionÉtape 3 : charger et rechercher des donnéesGestion des erreursÉtape 4 : supprimer la collectionÉtapes suivantes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Démarrage avec Amazon OpenSearch Serverless

Ce didacticiel explique les étapes de base pour qu'une collection de recherche Amazon OpenSearch Serverless soit rapidement opérationnelle. Avec une collection de recherche, vous pouvez alimenter les applications de vos réseaux internes et les applications connectées à Internet, telles que la recherche sur les sites Web de commerce électronique et la recherche de contenu.

Pour savoir comment utiliser une collection de recherche vectorielle, voirUtilisation de collections de recherche vectorielle. Pour des informations plus détaillées sur l'utilisation des collections, consultez Gestion des collections Amazon OpenSearch Serverless et les autres rubriques de ce guide.

Dans ce didacticiel, vous devez suivre les étapes suivantes :

  1. Configurer des autorisations

  2. Créer une collection

  3. Charger et rechercher des données

  4. Supprimer la collection

    Note

    Utilisez uniquement des caractères ASCII pour votre. IndexName Si vous n'utilisez pas de caractères ASCII pour votre compteIndexName, les CloudWatch métriques saisies sont converties IndexName en un format URL codé pour les caractères non ASCII.

Étape 1 : configurer des autorisations

Pour suivre ce didacticiel et pour utiliser OpenSearch Serverless en général, vous devez disposer des autorisations IAM appropriées. Dans ce didacticiel, vous allez créer une collection, télécharger et rechercher des données, puis supprimer la collection.

Votre utilisateur ou votre rôle doit être associé à une politique basée sur l'identité avec les autorisations minimales suivantes :

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": "*"
    }
  ]
}

Pour plus d'informations sur les autorisations IAM OpenSearch sans serveur, consultez. Identity and Access Management pour Amazon OpenSearch Serverless

Étape 2 : créer une collection

Une collection est un groupe d' OpenSearch index qui fonctionnent ensemble pour prendre en charge une charge de travail ou un cas d'utilisation spécifique.

Pour créer une collection OpenSearch sans serveur

  1. Ouvrez la console Amazon OpenSearch Service à l'adresse https://console.aws.amazon.com/aos/home.

  2. Dans le volet de navigation de gauche, sélectionnez Collections.

  3. Choisissez Create collection (Créer une collection).

  4. Pour Nom, saisissez movies.

  5. Pour Type de collection, choisissez Rechercher. Pour plus d'informations, consultez Choisir un type de collection.

  6. Pour la méthode de création de collection, choisissez Express Create.

  7. Passez en revue les paramètres par défaut. Il s'agit notamment du groupe de collecte, des paramètres de l'application de l' OpenSearchinterface utilisateur Clé détenue par AWS, du chiffrement avec un accès au réseau public et de la politique d'accès aux données générée automatiquement.

  8. Choisissez Create collection (Créer une collection).

  9. Attendez que le statut de la collecte passe àActive. Cela peut prendre plusieurs minutes.

Astuce

Ce didacticiel utilise la méthode NextGen Express Create. Vous pouvez également accéder à Express Create à partir du bouton Express Create dans le bandeau d'information de la page d'accueil pour accélérer le processus. Pour mieux contrôler le chiffrement, le réseau et les paramètres d'accès aux données, utilisez Standard Create. Pour utiliser l'assistant de création de collection classique, choisissez Passer à la version classique. Pour de plus amples informations, veuillez consulter Créer des collections.

Étape 3 : charger et rechercher des données

Vous pouvez télécharger des données vers une collection OpenSearch sans serveur à l'aide de Postman ou cURL. Pour des raisons de simplicité, ces exemples utilisent les outils de développement de la console OpenSearch Dashboards.

Indexer et rechercher des données dans la collection movies

  1. Choisissez Collections dans le panneau de navigation de gauche, puis choisissez la collection movies pour afficher sa page des détails.

  2. Choisissez l'URL OpenSearch des tableaux de bord pour la collection. L'URL est au format https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}.

  3. Dans OpenSearch Dashboards, ouvrez le volet de navigation de gauche et choisissez Dev Tools.

  4. Pour créer un index unique appelé movies-index, envoyez la requête suivante :

    PUT movies-index
    OpenSearch Console de tableaux de bord affichant la demande PUT à movies-index avec le statut de réponse 200.

  5. Pour indexer un seul document dans movies-index, envoyez la requête suivante :

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

  6. Pour rechercher des données dans OpenSearch les tableaux de bord, vous devez configurer au moins un modèle d'index. OpenSearch utilise ces modèles pour identifier les index que vous souhaitez analyser. Ouvrez le panneau de navigation de gauche, choisissez Stack Management (Gestion des piles), choisissez Index Patterns (Modèles d'index), puis Create index pattern (Créer un modèle d'index). Dans le cadre de ce tutoriel, saisissez movies.

  7. Choisissez Next step (Étape suivante), puis Create index pattern (Créer un modèle d'index). Une fois le modèle créé, vous pouvez consulter les différents champs du document, comme title et genre.

  8. Pour commencer à rechercher vos données, ouvrez à nouveau le volet de navigation de gauche et choisissez Discover, ou utilisez l'API de recherche dans Dev Tools.

Gestion des erreurs

Lorsque vous exécutez des opérations d'index et de recherche, vous pouvez obtenir les réponses d'erreur suivantes :

  • HTTP 507— Indique qu'une erreur interne du serveur s'est produite. Cette erreur indique généralement que vos unités de OpenSearch calcul (OCU) sont surchargées par le volume ou la complexité de vos demandes. Bien que le mode OpenSearch Serverless s'adapte automatiquement pour gérer la charge, le déploiement de ressources supplémentaires peut être retardé.

    Pour atténuer cette erreur, implémentez une politique de rétentative exponentielle. Cette approche réduit temporairement le taux de demandes afin de gérer efficacement la charge. Pour plus de détails, reportez-vous à la section Comportement d'une nouvelle tentative dans le Guide de référence AWS des SDK et des outils.

  • HTTP 402— Indique que vous avez atteint la limite de capacité maximale de l'unité de OpenSearch calcul (OCU). Optimisez votre charge de travail pour réduire l'utilisation de l'OCU ou demander une augmentation de quota.

Étape 4 : supprimer la collection

La collection de films étant destinée à des fins de test, supprimez-la lorsque vous aurez terminé d'expérimenter.

Pour supprimer une collection OpenSearch sans serveur

  1. Revenez à la console Amazon OpenSearch Service.

  2. Choisissez Collections dans le panneau de navigation de gauche et sélectionnez la collection movies.

  3. Choisissez Delete (Supprimer) et confirmez la suppression.

Étapes suivantes

Maintenant que vous savez comment créer une collection et indexer des données, vous pouvez essayer ce qui suit :