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*, voir[Utilisation de collections de recherche vectorielle](serverless-vector-search.md). Pour des informations plus détaillées sur l'utilisation des collections, consultez [Gestion des collections Amazon OpenSearch Serverless](serverless-manage.md) et les autres rubriques de ce guide.
Dans le cadre de ce didacticiel, vous suivrez les étapes suivantes :
1. [Configurer des autorisations](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [Créer une collection](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [Charger et rechercher des données](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [Supprimer la collection](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**Note**
Nous vous recommandons de n'utiliser que des caractères ASCII pour votre. `IndexName` Si vous n'utilisez pas de caractères ASCII pour votre compte`IndexName`, les CloudWatch métriques entrantes seront converties `IndexName` en un format codé URL 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 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é](security-iam-serverless.md#security-iam-serverless-id-based-policies) 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](security-iam-serverless.md)
## É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](https://console.aws.amazon.com/aos/home ).
1. Choisissez **Collections** dans le panneau de navigation de gauche, puis choisissez **Create collection** (Créer une collection).
1. Nommez la collection **movies** (films).
1. Pour le type de collection, choisissez **Search** (Rechercher). Pour plus d'informations, consultez [Choisir un type de collection](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase).
1. Pour **Sécurité**, choisissez **Création standard**.
1. 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.
1. 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.
1. Choisissez **Suivant**.
1. 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](serverless-data-access.md) 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).
1. Choisissez **Ajouter des principaux, des** **utilisateurs et des rôles IAM**, 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 **Enregistrer**.
1. Sous **Index permissions** (Autorisations d'index), sélectionnez toutes les autorisations.
1. Choisissez **Suivant**.
1. 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).
1. Choisissez **Suivant**.
1. 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 vers une collection OpenSearch sans serveur à l'aide de [Postman ou cURL](https://www.postman.com/downloads/). 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.
1. 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}`.
1. Dans OpenSearch Dashboards, ouvrez le volet de navigation de gauche et choisissez **Dev Tools**.
1. 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.\]](http://docs.aws.amazon.com/fr_fr/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. 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
}
```
1. 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*.
1. 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`.
1. Pour commencer à rechercher vos données, ouvrez à nouveau le panneau de navigation de gauche et choisissez **Discover** (Découvrir), ou utilisez l'[API de recherche](https://opensearch.org/docs/latest/api-reference/search/) dans les outils de développement.
## 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 (OCUs) 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](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) tentative dans le *guide de référence AWS SDKs et Tools*.
+ `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
É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**.
1. Choisissez **Collections** dans le panneau de navigation de gauche et sélectionnez la collection **movies**.
1. 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 :
+ Découvrez des options de création de collection plus avancées. Pour de plus amples informations, veuillez consulter [Gestion des collections Amazon OpenSearch Serverless](serverless-manage.md).
+ Découvrez comment configurer des stratégies de sécurité pour gérer la sécurité des collections à grande échelle. Pour de plus amples informations, veuillez consulter [Présentation de la sécurité dans Amazon OpenSearch Serverless](serverless-security.md).
+ Découvrez d'autres moyens d'indexer les données dans des collections. Pour de plus amples informations, veuillez consulter [Ingestion de données dans des collections Amazon OpenSearch Serverless](serverless-clients.md).