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.
# Commencez à utiliser Amazon DocumentDB
Il existe de nombreuses manières de se connecter et de démarrer avec Amazon DocumentDB. Ce guide est le moyen le plus rapide, le plus simple et le plus simple pour les utilisateurs de commencer à utiliser notre puissante base de données de documents. Ce guide permet [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html)de connecter et d'interroger votre cluster Amazon DocumentDB directement depuis le. AWS Management Console Les nouveaux clients éligibles au niveau AWS gratuit peuvent utiliser Amazon DocumentDB CloudShell gratuitement. Si votre AWS CloudShell environnement ou votre cluster Amazon DocumentDB utilise des ressources au-delà du niveau gratuit, les AWS tarifs normaux vous sont facturés pour ces ressources. Ce guide vous permettra de démarrer avec Amazon DocumentDB en moins de cinq minutes.
**Note**
Les instructions de ce guide concernent spécifiquement la création et la connexion à des clusters basés sur des instances Amazon DocumentDB dans lesquels Amazon DocumentDB et Amazon DocumentDB sont disponibles. AWS CloudShell
Si vous souhaitez créer des clusters élastiques Amazon DocumentDB et vous y connecter, consultez. [Commencez avec les clusters élastiques Amazon DocumentDB](elastic-get-started.md)
Si vous résidez dans les régions de AWS Chine, consultez[Connect Amazon EC2 automatiquement](connect-ec2-auto.md).
**Topics**
+ [Prérequis](#quickstart-prerequisites)
+ [Étape 1 : créer un cluster](#get-start-cluster)
+ [Étape 2 : Connectez-vous à votre cluster](#get-start-connectcluster)
+ [Étape 3 : Insérer et interroger des données](#get-start-insert-query)
+ [Étape 4 : Explorez](#get-start-congrats)
## Prérequis
Avant de créer votre premier cluster Amazon DocumentDB, vous devez effectuer les opérations suivantes :
**Créez un compte Amazon Web Services (AWS)**
Avant de pouvoir commencer à utiliser Amazon DocumentDB, vous devez disposer d'un compte Amazon Web Services (AWS). Le AWS compte est gratuit. Vous payez uniquement les services et les ressources que vous utilisez.
Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.
**Pour vous inscrire à un Compte AWS**
1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS*est créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les [tâches nécessitant un accès utilisateur racine](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**Configurez les autorisations Gestion des identités et des accès AWS (IAM) nécessaires.**
L'accès à la gestion des ressources Amazon DocumentDB telles que les clusters, les instances et les groupes de paramètres de cluster nécessite des informations d'identification AWS pouvant être utilisées pour authentifier vos demandes. Pour de plus amples informations, veuillez consulter [Identity and Access Management pour Amazon DocumentDB](security-iam.md).
1. Dans la barre de recherche du AWS Management Console, tapez IAM et sélectionnez **IAM** dans le menu déroulant qui apparaît.
1. Une fois dans la console IAM, sélectionnez **Utilisateurs** dans le volet de navigation.
1. Sélectionnez votre nom d'utilisateur.
1. Cliquez sur **Add permissions (Ajouter des autorisations)**.
1. Sélectionnez **Joindre directement les politiques**.
1. Tapez `AmazonDocDBFullAccess` dans la barre de recherche et sélectionnez-la une fois qu'elle apparaît dans les résultats de recherche.
1. Cliquez sur **Next** (Suivant).
1. Cliquez sur **Add permissions (Ajouter des autorisations)**.
****
Votre AWS compte inclut un VPC par défaut dans chaque région. Si vous choisissez d'utiliser un Amazon VPC, suivez les étapes décrites dans la rubrique [Créer un Amazon VPC du Guide de l'utilisateur Amazon *VPC*](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html).
## Étape 1 : créer un cluster
Au cours de cette étape, vous allez créer un cluster Amazon DocumentDB.
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. **Sur la console de gestion Amazon DocumentDB, sous **Clusters**, choisissez Create.**
![\[Tableau de bord des clusters vide avec des options pour créer un nouveau cluster et gérer les ressources.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-gs-start.png)
1. Sur la page Créer un cluster Amazon DocumentDB, dans la section **Type de cluster**, sélectionnez Cluster **basé sur une instance** (il s'agit de l'option par défaut).
![\[Sélection du type de cluster avec l'option Cluster basé sur l'instance mise en évidence et description des deux types de cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cluster-type.png)
**Note**
L'autre option de cette catégorie est le **cluster élastique**. Pour en savoir plus sur les clusters élastiques Amazon DocumentDB, consultez [Utilisation des clusters élastiques Amazon DocumentDB](docdb-using-elastic-clusters.md)
1. Dans la section **Configuration du cluster** :
1. Dans le **champ Identifiant du cluster**, entrez un nom unique, tel que**mydocdbcluster**. Notez que la console remplacera tous les noms de clusters en minuscules, quelle que soit la manière dont ils sont saisis.
1. Pour la **version Engine**, choisissez **5.0.0.**
![\[Formulaire de configuration pour un cluster de base de données avec des champs pour l'identifiant et la version du moteur.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cluster-config.png)
1. Dans la section **Configuration du stockage en cluster**, choisissez **Amazon DocumentDB Standard** (il s'agit de l'option par défaut).
![\[Sélection du type de stockage avec l'option Amazon DocumentDB Standard mise en évidence et description des deux types de stockage.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cluster-storage.png)
**Note**
L'autre option de cette catégorie est **Amazon DocumentDB** I/O-Optimized. Pour en savoir plus sur l'une ou l'autre option, voir [Configurations de stockage en cluster Amazon DocumentDB](db-cluster-storage-configs.md)
1. Dans la section **Configuration de l'instance** :
1. Pour la **classe d'instance de** base de données, choisissez **Classes optimisées pour la mémoire (inclure les classes r)** (par défaut).
L'autre option d'instance est celle des **classes NVMe soutenues par -back**. Pour en savoir plus, veuillez consulter la section [Instances basées sur les volumes NVMe](db-instance-nvme.md).
1. Pour la **classe d'instance**, choisissez **db.t3.medium**. Ceci est éligible à l'essai AWS gratuit.
1. Pour **Nombre d'instances**, sélectionnez **1** instance. Le choix d'une instance permet de minimiser les coûts. S'il s'agissait d'un système de production, nous vous recommandons de fournir trois instances pour une haute disponibilité.
![\[Formulaire de configuration pour une instance de base de données avec des champs pour la classe d'instance de base de données, la classe d'instance prise en charge et le nombre d'instances.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. Dans la section **Connectivité**, laissez le paramètre par défaut **Ne pas se connecter à une ressource de EC2 calcul**.
![\[Paramètres de connectivité pour la base de données avec options permettant de se connecter ou de ne pas se connecter à une ressource de EC2 calcul.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cluster-connectivity-no-ec2.png)
1. Dans la section **Authentification**, entrez un nom d'utilisateur pour l'utilisateur principal, puis choisissez **Autogéré**. Entrez un mot de passe, puis confirmez-le.
Si vous avez plutôt choisi **Managed in AWS Secrets Manager**, consultez [Gestion des mots de passe avec Amazon DocumentDB et AWS Secrets Manager](docdb-secrets-manager.md) pour plus d'informations.
![\[Sélection du type d'authentification avec l' AWS Secrets Manager option Managed in surlignée et les deux types d'authentification décrits.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cluster-auth-self.png)
1. Conservez toutes les autres options par défaut et choisissez **Create cluster**.
Amazon DocumentDB est en train de provisionner votre cluster, ce qui peut prendre jusqu'à quelques minutes.
**Note**
Pour plus d'informations sur les valeurs d'état du cluster, consultez [Valeurs d'état du cluster](monitoring_docdb-cluster_status.md#monitoring_docdb-status_values) le chapitre Monitoring Amazon DocumentDB.
## Étape 2 : Connectez-vous à votre cluster
Connectez-vous à votre cluster Amazon DocumentDB à l'aide de. AWS CloudShell
1. Sur la console de gestion Amazon DocumentDB, sous **Clusters**, recherchez le cluster que vous avez créé. Choisissez votre cluster en cochant la case à côté de celui-ci.
![\[Interface de gestion de cluster Amazon DocumentDB affichant un cluster régional avec les détails de l'instance principale\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-connect-cloud-shell.png)
1. Cliquez sur **Connect to cluster** (situé à côté du menu déroulant **Actions**). **Ce bouton n'est activé qu'une fois que vous avez coché la case à côté de votre cluster et que le statut du cluster régional et des instances principales est indiqué comme Disponible.** L'écran CloudShell **Exécuter la commande** apparaît.
1. Dans le champ **Nom du nouvel environnement**, entrez un nom unique, tel que « test », puis cliquez sur **Créer et exécuter**. Les détails de l'environnement VPC sont automatiquement configurés pour votre base de données Amazon DocumentDB.
![\[Cluster de clusters CloudShell Exécuter un écran de commande demandant le nouveau nom d'environnement\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-gs-run-command.png)
1. Lorsque vous y êtes invité, entrez le mot de passe que vous avez créé à l'étape 1 : Création d'un cluster Amazon DocumentDB (sous-étape 7).
![\[CloudShell Écran du cluster demandant le mot de passe utilisateur\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-gs-cs-password.png)
Une fois que vous avez saisi votre mot de passe et que vous y êtes invité`rs0 [direct: primary] >`, vous êtes connecté avec succès à votre cluster Amazon DocumentDB.
**Note**
Pour plus d'informations sur le dépannage, consultez la section Résolution des [problèmes liés à Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html).
## Étape 3 : Insérer et interroger des données
Maintenant que vous êtes connecté à votre cluster, vous pouvez exécuter quelques requêtes pour vous familiariser avec l'utilisation d'une base de données de documents.
1. Pour insérer un seul document, entrez les informations suivantes :
```
db.collection.insertOne({"hello":"DocumentDB"})
```
Vous obtenez le résultat suivant :
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. Vous pouvez lire le document que vous avez écrit avec la `findOne()` commande (car il ne renvoie qu'un seul document). Entrez les informations suivantes :
```
db.collection.findOne()
```
Vous obtenez le résultat suivant :
```
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
```
1. Pour effectuer quelques requêtes supplémentaires, considérez un cas d'utilisation de profils de jeu. Tout d'abord, insérez quelques entrées dans une collection intitulée`profiles`. Entrez les informations suivantes :
```
db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 },
{ _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 },
{ _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 },
{ _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 }
])
```
Vous obtenez le résultat suivant :
```
{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }
```
1. Utilisez la `find()` commande pour renvoyer tous les documents de la collection de profils. Entrez les informations suivantes :
```
db.profiles.find()
```
Vous obtiendrez une sortie qui correspondra aux données que vous avez saisies à l'étape 3.
1. Utilisez une requête pour un seul document à l'aide d'un filtre. Entrez les informations suivantes :
```
db.profiles.find({name: "Katie"})
```
Vous obtenez le résultat suivant :
```
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
```
1. Essayons maintenant de trouver un profil et de le modifier à l'aide de la `findAndModify` commande. Nous donnerons à l'utilisateur Matt 10 points supplémentaires avec le code suivant :
```
db.profiles.findAndModify({
query: { name: "Matt", status: "active"},
update: { $inc: { score: 10 } }
})
```
Vous obtenez le résultat suivant (notez que son score n'a pas encore augmenté) :
```
{
[{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]
```
1. Vous pouvez vérifier que son score a changé à l'aide de la requête suivante :
`db.profiles.find({name: "Matt"})`
Vous obtenez le résultat suivant :
```
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
```
## Étape 4 : Explorez
Félicitations \$1 Vous avez terminé avec succès le guide de démarrage pour les clusters basés sur des instances Amazon DocumentDB.
Quelle est la prochaine étape ? Découvrez comment tirer pleinement parti de cette base de données grâce à certaines de ses fonctionnalités les plus populaires :
+ [Gestion d'Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [Dimensionnement](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [Sauvegarde et restauration](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**Note**
Le cluster que vous avez créé à partir de cet exercice de démarrage continuera à générer des coûts à moins que vous ne le supprimiez. Pour obtenir des instructions, consultez [Supprimer un cluster Amazon DocumentDB.](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-delete.html)