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.
# Créer des collections
Vous pouvez utiliser la console ou le AWS CLI pour créer une collection sans serveur. Ces étapes expliquent comment créer une *recherche* ou une collection de *séries chronologiques*. Pour créer une collection *de recherche vectorielle*, voir[Utilisation de collections de recherche vectorielle](serverless-vector-search.md).
**Topics**
+ [Créer une collection (console)](serverless-create-console.md)
+ [Créer une collection (CLI)](serverless-create-cli.md)
# Créer une collection (console)
Suivez les procédures décrites dans cette section pour créer une collection à l'aide du AWS Management Console. Ces étapes expliquent comment créer une *recherche* ou une collection de *séries chronologiques*. Pour créer une collection *de recherche vectorielle*, voir[Utilisation de collections de recherche vectorielle](serverless-vector-search.md).
**Topics**
+ [Configuration des paramètres de collecte](#serverless-create-console-step-2)
+ [Configuration de champs de recherche supplémentaires](#serverless-create-console-step-3)
## Configuration des paramètres de collecte
Utilisez la procédure suivante pour configurer les informations relatives à votre collection.
**Pour configurer les paramètres de collecte à l'aide de la console**
1. Accédez à la console Amazon OpenSearch Service à l'adresse [https://console.aws.amazon.com/aos/home/](https://console.aws.amazon.com/aos/home/).
1. Développez **Serverless** (Sans serveur) dans le panneau de navigation de gauche et choisissez **Collections**.
1. Choisissez **Create collection** (Créer une collection).
1. Saisissez un nom et une description pour la collection. Le nom doit répondre aux critères suivants :
+ est propre à votre compte et Région AWS
+ Contient uniquement les lettres minuscules a-z, les chiffres 0-9 et le trait d'union (-)
+ Contient entre 3 et 32 caractères
1. Choisissez un type de collection :
+ **Séries temporelles** : segment d'analyse des journaux qui se concentre sur des gros volumes de données semi-structurées et générées par des machines. Au moins 24 heures de données sont stockées sur des index chauds, le reste étant stocké à chaud.
+ **Recherche** : recherche en texte intégral qui alimente les applications de vos réseaux internes et les applications disponibles sur Internet. Toutes les données de recherche sont stockées dans le stockage à chaud afin de garantir des temps de réponse rapides aux requêtes.
**Note**
Choisissez cette option si vous activez la recherche sémantique automatique, comme décrit dans[Configuration des paramètres de collecte](#serverless-create-console-step-2).
+ **Recherche vectorielle : recherche** sémantique sur les intégrations vectorielles qui simplifie la gestion des données vectorielles. Favorise les expériences de recherche augmentées par le machine learning (ML) et les applications d'IA génératives telles que les chatbots, les assistants personnels et la détection des fraudes.
Pour de plus amples informations, veuillez consulter [Choix d'un type de collection](serverless-overview.md#serverless-usecase).
1. Pour **Type de déploiement**, choisissez le paramètre de redondance pour votre collection. Par défaut, chaque collection est redondante, ce qui signifie que les unités de OpenSearch calcul d'indexation et de recherche (OCUs) disposent chacune de leurs propres répliques de secours dans une zone de disponibilité différente. À des fins de développement et de test, vous pouvez choisir de désactiver la redondance, ce qui réduit à deux le nombre de OCUs membres de votre collection. Pour de plus amples informations, veuillez consulter [Comment ça marche](serverless-overview.md#serverless-process).
1. Pour **Sécurité**, choisissez **Création standard**.
1. Pour **le chiffrement**, choisissez une AWS KMS clé pour chiffrer vos données. OpenSearch Serverless vous avertit si le nom de collection que vous avez saisi correspond à un modèle défini dans une politique de chiffrement. Vous pouvez choisir de conserver cette correspondance ou de la remplacer par des paramètres de chiffrement uniques. Pour de plus amples informations, veuillez consulter [Chiffrement dans Amazon OpenSearch Serverless](serverless-encryption.md).
1. Pour les **paramètres d'accès réseau**, configurez l'accès réseau pour la collection.
+ Pour le **type d'accès**, sélectionnez public ou privé.
Si vous choisissez privé, spécifiez les points de terminaison VPC autorisés à Services AWS accéder à la collection.
+ **Points de terminaison VPC pour l'accès** : spécifiez un ou plusieurs points de terminaison VPC pour autoriser l'accès. Pour créer un point de terminaison d'un VPC, veuillez consulter la rubrique [Accès au plan de données via AWS PrivateLink](serverless-vpc.md).
+ **Service AWS accès privé** : sélectionnez un ou plusieurs services pris en charge auxquels vous souhaitez autoriser l'accès.
+ Pour le **type de ressource**, indiquez si les utilisateurs peuvent accéder à la collection via son *OpenSearch*point de terminaison (pour effectuer des appels d'API via cURL, Postman, etc.), via le point de terminaison *OpenSearch Dashboards* (pour travailler avec des visualisations et effectuer des appels d'API via la console), ou les deux.
**Note**
Service AWS l'accès privé s'applique uniquement au OpenSearch point de terminaison, pas au point de terminaison OpenSearch des tableaux de bord.
OpenSearch Serverless vous avertit si le nom de collection que vous avez saisi correspond à un modèle défini dans une politique réseau. Vous pouvez choisir de conserver cette correspondance ou de la remplacer par des paramètres réseau personnalisés. Pour de plus amples informations, veuillez consulter [Accès au réseau pour Amazon OpenSearch Serverless](serverless-network.md).
1. (Facultatif) Ajoutez une ou plusieurs balises à la collection. Pour de plus amples informations, veuillez consulter [Marquage des collections Amazon OpenSearch Serverless](tag-collection.md).
1. Choisissez **Suivant**.
## Configuration de champs de recherche supplémentaires
Les options affichées à la page 2 du flux de travail de création de collection dépendent du type de collection que vous créez. Cette section explique comment configurer des champs de recherche supplémentaires pour chaque type de collection. Cette section décrit également comment configurer l'enrichissement sémantique automatique. Ignorez les sections qui ne s'appliquent pas à votre type de collection.
**Topics**
+ [Configuration de l'enrichissement sémantique automatique](#serverless-create-console-step-3-semantic-enrichment-fields)
+ [Configuration des champs de recherche de séries chronologiques](#serverless-create-console-step-3-time-series-fields)
+ [Configuration des champs de recherche lexicaux](#serverless-create-console-step-3-lexical-fields)
+ [Configuration des champs de recherche vectorielle](#serverless-create-console-step-3-vector-search-fields)
### Configuration de l'enrichissement sémantique automatique
Lorsque vous créez ou modifiez une collection, vous pouvez configurer l'enrichissement sémantique automatique, ce qui simplifie la mise en œuvre et les fonctionnalités de recherche sémantique dans Amazon OpenSearch Service. La recherche sémantique renvoie des résultats de requête qui intègrent non seulement la correspondance des mots clés, mais aussi l'intention et le sens contextuel de la recherche de l'utilisateur. Pour de plus amples informations, veuillez consulter [Enrichissement sémantique automatique pour Serverless](serverless-semantic-enrichment.md).
**Pour configurer l'enrichissement sémantique automatique**
1. Dans la section **Détails de l'index**, pour **Nom de l'index**, spécifiez un nom.
1. Dans la section **Champs d'enrichissement sémantique automatique**, choisissez **Ajouter un champ de recherche sémantique**.
1. Dans le **champ Nom du champ d'entrée pour l'enrichissement sémantique**, entrez le nom du champ que vous souhaitez enrichir.
1. Le **type de données** est **Texte**. Vous ne pouvez pas modifier cette valeur.
1. Pour **Langue**, choisissez **Anglais** ou **Multilingue**.
1. Choisissez **Ajouter un champ**.
1. Une fois que vous avez fini de configurer les champs facultatifs pour votre collection, choisissez **Next**. Passez en revue vos modifications et choisissez **Soumettre** pour créer la collection.
### Configuration des champs de recherche de séries chronologiques
Les options de la section **Champs de recherche des séries chronologiques** concernent les données des séries chronologiques et les flux de données. Pour plus d'informations sur ces sujets, consultez[Gestion des séries chronologiques dans Amazon OpenSearch Service à l'aide de flux de données](data-streams.md).
**Pour configurer les champs de recherche de séries chronologiques**
1. Dans la section **Champs de recherche de séries chronologiques**, choisissez **Ajouter un champ de série chronologique**.
1. Pour **Nom du champ**, entrez un nom.
1. Pour **Type de données**, choisissez-en un dans la liste.
1. Choisissez **Ajouter un champ**
1. Une fois que vous avez fini de configurer les champs facultatifs pour votre collection, choisissez **Next**. Passez en revue vos modifications et choisissez **Soumettre** pour créer la collection.
### Configuration des champs de recherche lexicaux
La recherche lexicale cherche à obtenir une correspondance exacte entre une requête de recherche et des termes ou mots clés indexés.
**Pour configurer les champs de recherche lexicaux**
1. Dans la section **Champs de recherche lexicaux**, choisissez **Ajouter un champ de recherche**.
1. Pour **Nom du champ**, entrez un nom.
1. Pour **Type de données**, choisissez-en un dans la liste.
1. Choisissez **Ajouter un champ**
1. Une fois que vous avez fini de configurer les champs facultatifs pour votre collection, choisissez **Next**. Passez en revue vos modifications et choisissez **Soumettre** pour créer la collection.
### Configuration des champs de recherche vectorielle
**Pour configurer les champs de recherche vectorielle**
1. Dans la section **Champs vectoriels**, choisissez **Ajouter un champ vectoriel**.
1. Pour **Nom du champ**, entrez un nom.
1. Pour **Engine**, choisissez un type dans la liste.
1. Entrez le nombre de dimensions.
1. Pour **Distance Metric**, choisissez un type dans la liste.
1. Une fois que vous avez fini de configurer les champs facultatifs pour votre collection, choisissez **Next**.
1. Passez en revue vos modifications et choisissez **Soumettre** pour créer la collection.
# Créer une collection (CLI)
Utilisez les procédures décrites dans cette section pour créer une collection OpenSearch sans serveur à l'aide du AWS CLI.
**Topics**
+ [Avant de commencer](#serverless-create-cli-before-you-begin)
+ [Création d’une collection](#serverless-create-cli-creating)
+ [Création d'une collection avec un index d'enrichissement sémantique automatique](#serverless-create-cli-automatic-semantic-enrichment)
## Avant de commencer
Avant de créer une collection à l'aide de AWS CLI, suivez la procédure suivante pour créer les politiques requises pour la collection.
**Note**
Dans chacune des procédures suivantes, lorsque vous spécifiez le nom d'une collection, celui-ci doit répondre aux critères suivants :
est propre à votre compte et Région AWS
Contient uniquement les lettres minuscules a-z, les chiffres 0-9 et le trait d'union (-)
Contient entre 3 et 32 caractères
**Pour créer les politiques requises pour une collection**
1. Ouvrez le AWS CLI et exécutez la commande suivante pour créer une [politique de chiffrement](serverless-encryption.md) avec un modèle de ressource correspondant au nom prévu de la collection.
```
&aws opensearchserverless create-security-policy \
--name policy name \
--type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AWSOwnedKey\":true}"
```
Par exemple, si vous envisagez de nommer votre collection *logs-application*, vous pouvez créer une stratégie de chiffrement comme suit :
```
&aws opensearchserverless create-security-policy \
--name logs-policy \
--type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"
```
Si vous envisagez d'utiliser la stratégie pour des collections supplémentaires, vous pouvez élargir la règle, par exemple `collection/logs*` ou `collection/*`.
1. Exécutez la commande suivante pour configurer les paramètres réseau de la collection à l'aide d'une [politique réseau](serverless-network.md). Vous pouvez créer des stratégies réseau après avoir créé une collection, mais nous vous recommandons de le faire au préalable.
```
&aws opensearchserverless create-security-policy \
--name policy name \
--type network --policy "[{\"Description\":\"description\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/collection name\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AllowFromPublic\":true}]"
```
À l'aide de l'exemple *logs-application* précédent, vous pouvez créer la stratégie réseau suivante :
```
&aws opensearchserverless create-security-policy \
--name logs-policy \
--type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"
```
## Création d’une collection
La procédure suivante utilise l'action [CreateCollection](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollection.html)API pour créer une collection de type `SEARCH` ou`TIMESERIES`. Si vous ne spécifiez pas de type de collection dans la demande, il est défini par défaut à `TIMESERIES`. Pour plus d'informations sur ces types, consultez[Choix d'un type de collection](serverless-overview.md#serverless-usecase). Pour créer une collection *de recherche vectorielle*, voir[Utilisation de collections de recherche vectorielle](serverless-vector-search.md).
Si votre collection est chiffrée avec un Clé détenue par AWS, `kmsKeyArn` c'est `auto` plutôt qu'un ARN.
**Important**
Une fois la collection créée, vous ne pourrez y accéder que si elle correspond à une stratégie d'accès aux données. Pour de plus amples informations, veuillez consulter [Contrôle d'accès aux données pour Amazon OpenSearch Serverless](serverless-data-access.md).
**Pour créer une collection**
1. Vérifiez que vous avez créé les politiques requises décrites dans[Avant de commencer](#serverless-create-cli-before-you-begin).
1. Exécutez la commande suivante. Pour `type` spécifier l'un `SEARCH` ou l'autre`TIMESERIES`.
```
&aws opensearchserverless create-collection --name "collection name" --type collection type --description "description"
```
## Création d'une collection avec un index d'enrichissement sémantique automatique
Utilisez la procédure suivante pour créer une nouvelle collection OpenSearch Serverless avec un index configuré pour un enrichissement [sémantique automatique](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-semantic-enrichment.html). La procédure utilise l'action d'[CreateIndex](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateIndex.html)API OpenSearch Serverless.
**Pour créer une nouvelle collection avec un index configuré pour un enrichissement sémantique automatique**
Exécutez la commande suivante pour créer la collection et un index.
```
&aws opensearchserverless create-index \
--region Region ID \
--id collection name --index-name index name \
--index-schema \
'mapping in json'
```
Voici un exemple :
```
&aws opensearchserverless create-index \
--region us-east-1 \
--id conversation_history --index-name conversation_history_index \
--index-schema \
'{
"mappings": {
"properties": {
"age": {
"type": "integer"
},
"name": {
"type": "keyword"
},
"user_description": {
"type": "text"
},
"conversation_history": {
"type": "text",
"semantic_enrichment": {
"status": "ENABLED",
// Specifies the sparse tokenizer for processing multi-lingual text
"language_option": "MULTI-LINGUAL",
// If embedding_field is provided, the semantic embedding field will be set to the given name rather than original field name + "_embedding"
"embedding_field": "conversation_history_user_defined"
}
},
"book_title": {
"type": "text",
"semantic_enrichment": {
// No embedding_field is provided, so the semantic embedding field is set to "book_title_embedding"
"status": "ENABLED",
"language_option": "ENGLISH"
}
},
"abstract": {
"type": "text",
"semantic_enrichment": {
// If no language_option is provided, it will be set to English.
// No embedding_field is provided, so the semantic embedding field is set to "abstract_embedding"
"status": "ENABLED"
}
}
}
}
}'
```