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*, 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 ce didacticiel, vous devez suivre 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**
Utilisez uniquement des caractères ASCII pour votre. `IndexName` Si vous n'utilisez pas de caractères ASCII pour votre compte`IndexName`, 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é](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 à l'adresse [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home).
1. Dans le volet de navigation de gauche, sélectionnez **Collections**.
1. Choisissez **Create collection** (Créer une collection).
1. Pour **Nom**, saisissez `movies`.
1. Pour **Type de collection**, choisissez **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 **la méthode de création de collection**, choisissez **Express Create**.
1. 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.
1. Choisissez **Create collection** (Créer une collection).
1. 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](serverless-create.md).
## É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/). 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.
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{{ }}
```
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 volet de navigation de gauche et choisissez **Discover**, ou utilisez l'[API de recherche](https://opensearch.org/docs/latest/api-reference/search/) 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](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) 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.
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, vous pouvez essayer ce qui suit :
+ Découvrez des options plus avancées pour créer une collection. Pour de plus amples informations, veuillez consulter [Gestion des collections Amazon OpenSearch Serverless](serverless-manage.md).
+ Configurez des politiques 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).
+ Utilisez d'autres méthodes pour 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).