Tutoriel : prise en main d'Amazon OpenSearch Serverless - Amazon OpenSearch Service
Étape 1 : configurer des autorisationsÉtape 2 : créer une collectionÉtape 3 : charger et rechercher des donnéesÉ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 : prise en main d'Amazon OpenSearch Serverless

Ce didacticiel vous explique les étapes de base pour mettre rapidement en place une collection de recherche Amazon OpenSearch Serverless. Une collection de recherche vous permet d'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 Création, mise en vente et suppression de collections Amazon OpenSearch Serverless et les autres rubriques de ce guide.

Dans le cadre de ce didacticiel, vous suivrez les étapes suivantes :

  1. Configurer des autorisations

  2. Créer une collection

  3. Charger et rechercher des données

  4. Supprimer la collection

    Note

    Il est recommandé de n'utiliser que des ASCII caractères pour votreIndexName. Si vous n'utilisez pas de ASCII caractères pour votreIndexName, les CloudWatch métriques IndexName entrantes seront converties en un format URL codé pour les caractères autres que les ASCII caractères.

Étape 1 : configurer des autorisations

Pour suivre ce didacticiel, et pour utiliser OpenSearch Serverless en général, vous devez disposer des IAM autorisations appropriées. Dans le cadre de ce didacticiel, vous allez créer une collection, 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 :

{
  "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 IAM autorisations OpenSearch sans serveur, consultezIdentity 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 à la https://console.aws.amazon.com/aos/maison.

  2. Choisissez Collections dans le panneau de navigation de gauche, puis choisissez Create collection (Créer une collection).

  3. Nommez la collection movies (films).

  4. Pour le type de collection, choisissez Search (Rechercher). Pour plus d'informations, consultez Choisir un type de collection.

  5. Pour Sécurité, choisissez Création standard.

  6. Sous Chiffrement, sélectionnez Utiliser Clé détenue par AWS. C'est ce AWS KMS key que OpenSearch Serverless utilisera pour chiffrer vos données.

  7. Sous Network (Réseau), configurez les paramètres réseau de la collection.

    • Pour le type d'accès, sélectionnez Public.

    • Pour le type de ressource, sélectionnez Activer l'accès aux OpenSearch points de terminaison et Activer l'accès aux OpenSearch tableaux de bord. Comme vous téléchargerez et rechercherez des données à l'aide de OpenSearch tableaux de bord, vous devez activer les deux.

  8. Choisissez Suivant.

  9. Pour Configure data access (Configurer l'accès aux données), configurez les paramètres d'accès pour la collection. Les stratégies d'accès aux données permettent aux utilisateurs et aux rôles d'accéder aux données d'une collection. Dans le cadre de ce didacticiel, nous allons fournir à un seul utilisateur les autorisations requises pour indexer et rechercher des données dans la collection movies.

    Créez une règle unique qui donne accès à la collection de films. Nommez la règle Movies collection access (Accès à la collection movies).

  10. Choisissez Ajouter des principaux, des IAM utilisateurs et des rôles, puis sélectionnez l'utilisateur ou le rôle que vous utiliserez pour vous connecter aux OpenSearch tableaux de bord et indexer les données. Choisissez Save (Enregistrer).

  11. Sous Index permissions (Autorisations d'index), sélectionnez toutes les autorisations.

  12. Choisissez Suivant.

  13. Pour les paramètres de la stratégie d'accès, choisissez Create a new data access policy (Créer une nouvelle stratégie d'accès aux données) et nommez la stratégie movies (films).

  14. Choisissez Suivant.

  15. Vérifiez vos paramètres de collection et choisissez Submit (Soumettre). Attendez quelques minutes pour que le statut de la collection devienne Active.

Étape 3 : charger et rechercher des données

Vous pouvez télécharger des données dans une collection OpenSearch sans serveur à l'aide de Postman ou c. URL Par souci de concision, 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 les OpenSearch tableaux de bord URL pour la collection. Le URL prend le formathttps://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 Dashboards console showing PUT request for movies-index with JSON response.

  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 la fonction de recherche API dans Dev Tools.

Étape 4 : supprimer la collection

Étant donné que la collection movies est destinée aux tests, veillez à la supprimer lorsque vous aurez fini de l'utiliser.

Pour supprimer une collection OpenSearch sans serveur

  1. Retournez à 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, n'hésitez pas à essayer les exercices suivants :