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.
Il existe de nombreuses manières de se connecter et de démarrer avec Amazon DocumentDB. Nous avons créé ce guide parce que nous avons trouvé que c'était 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 utilise Amazon Elastic Compute Cloud (Amazon EC2) pour connecter et interroger votre cluster Amazon DocumentDB directement depuis le. AWS Management Console Les nouveaux clients éligibles au niveau AWS gratuit peuvent utiliser Amazon DocumentDB et Amazon EC2 gratuitement. Si votre EC2 environnement Amazon 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 15 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. Si vous souhaitez créer des clusters élastiques Amazon DocumentDB et vous y connecter, consultez. Démarrez avec les clusters élastiques Amazon DocumentDB
Rubriques
Si vous préférez vous connecter à votre Amazon DocumentDB depuis votre machine locale en créant une connexion SSH vers une EC2 instance Amazon, consultez. Connect via Amazon EC2
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
Ouvrez l'https://portal.aws.amazon.com/billing/inscription.
Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique 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 AWSest 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.
- Configurez les autorisations AWS Identity and Access Management (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.
-
Dans la barre de recherche du AWS Management Console, tapez IAM et sélectionnez IAM dans le menu déroulant qui apparaît.
-
Une fois dans la console IAM, sélectionnez Utilisateurs dans le volet de navigation.
-
Sélectionnez votre nom d'utilisateur.
-
Cliquez sur le bouton Ajouter des autorisations.
-
Sélectionnez Attach existing policies directly (Attacher directement les politiques existantes).
-
Tapez
AmazonDocDBFullAccess
dans la barre de recherche et sélectionnez-la une fois qu'elle apparaît dans les résultats de recherche. -
Cliquez sur le bouton bleu en bas qui indique Suivant : Réviser.
-
Cliquez sur le bouton bleu en bas qui indique Ajouter des autorisations.
-
- Création d'un Amazon Virtual Private Cloud (Amazon VPC)
-
Votre AWS compte inclut un VPC par défaut dans chaque région. Cette étape n'est nécessaire que si vous choisissez d'utiliser un Amazon VPC par défaut. Dans ce cas, suivez les étapes décrites dans la rubrique Créer un Amazon VPC du Guide de l'utilisateur Amazon VPC.
- Lancer une EC2 instance Amazon
-
Suivez les étapes 1 et 2 de la EC2 rubrique Commencer avec Amazon dans le guide de l'utilisateur d'Amazon Elastic Compute Cloud.
Étape 1 : créer un cluster Amazon DocumentDB
Au cours de cette étape, vous allez créer un cluster Amazon DocumentDB.
-
Sur la console de gestion Amazon DocumentDB, sous Clusters, choisissez Create.
-
Sur la page Créer un cluster Amazon DocumentDB, dans la section Type de cluster, sélectionnez Instance Based Clusters (il s'agit de l'option par défaut).
-
Dans la section Configuration :
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.Pour la version Engine, choisissez 5.0.0.
Pour la classe d'instance, choisissez db.t3.medium. Ceci est éligible au niveau AWS gratuit.
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é.
-
Dans la section Configuration du stockage en cluster, choisissez Amazon DocumentDB Standard (il s'agit de l'option par défaut).
-
Dans la section Connectivité :
Sélectionnez Se connecter à une ressource EC2 de calcul.
Pour EC2 Instance, sélectionnez l' EC2 instance que vous avez créée dansPrérequis.
-
Dans la section Authentification, entrez un nom d'utilisateur pour l'utilisateur principal, puis choisissez un mot de passe AWS géré ou un mot de passe autogéré.
Si vous choisissez l'option AWS Secrets Manager, configurez la clé KMS en créant la vôtre ou en utilisant une clé créée par Secrets Manager.
Si vous choisissez de gérer vous-même le mot de passe de l'utilisateur principal, saisissez-le, puis confirmez-le.
-
Conservez toutes les autres options par défaut et choisissez Create cluster.
Note
Lorsque vous configurez une connexion entre une EC2 instance et une base de données Amazon DocumentDB, Amazon DocumentDB configure automatiquement le groupe de sécurité VPC pour votre instance EC2 et pour votre base de données Amazon DocumentDB. Pour de plus amples informations, veuillez consulter Vue d'ensemble de la connectivité automatique avec une EC2 instance.
Amazon DocumentDB est en train de provisionner votre cluster, ce qui peut prendre jusqu'à quelques minutes. Vous pouvez vous connecter à votre cluster lorsque l'état du cluster et de l'instance s'affichent comme disponibles.
Note
Pour plus d'informations sur les valeurs d'état du cluster, consultez Valeurs d'état du cluster le chapitre Monitoring Amazon DocumentDB.
Pour plus d'informations sur les valeurs de statut des instances, consultez Valeurs de l’état d'instance le chapitre Monitoring Amazon DocumentDB.
Étape 2 : Installation du shell Mongo
Installez le shell mongo dans votre EC2 instance Amazon que vous avez créée dansPrérequis. Le shell mongo est un utilitaire de ligne de commande que vous utilisez pour connecter et interroger votre cluster Amazon DocumentDB.
Connectez-vous à votre EC2 instance Amazon et, à l'invite de commande, créez le fichier de référentiel à l'aide de la commande suivante :
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
Une fois l'opération terminée, installez le shell mongo avec la commande suivante :
sudo yum install -y mongodb-org-shell
Étape 3 : Connectez-vous à votre cluster Amazon DocumentDB
Connectez-vous à votre cluster Amazon DocumentDB à l'aide du shell mongo que vous avez installé à l'étape 2.
-
Sur la console de gestion Amazon DocumentDB, sous Clusters, localisez votre cluster. Choisissez le cluster que vous avez créé en cliquant sur l'identifiant du cluster.
-
Encryption-in-transit est activé par défaut sur Amazon DocumentDB. Vous pouvez éventuellement désactiver le protocole TLS. Pour télécharger le certificat actuel requis pour vous authentifier auprès de votre cluster, dans l'onglet Connectivité et sécurité, dans la section Connect, sous Télécharger le certificat Amazon DocumentDB Certificate Authority (CA) requis pour vous authentifier auprès de votre cluster, copiez la commande fournie. Retournez sur votre EC2 instance Amazon et collez la commande.
-
Revenez à votre cluster dans la console Amazon DocumentDB, sous l'onglet Connectivité et sécurité, dans la section Connect, sous Connect to this cluster with the mongo shell, copiez la chaîne de connexion fournie. Omettez de copier
<insertYourPassword>
afin que le shell mongo vous demande le mot de passe lorsque vous vous connectez.Retournez sur votre EC2 instance Amazon et collez la chaîne de connexion.
Lorsque vous entrez votre mot de passe et que l'invite apparaîtrs0: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.
Étape 4 : 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.
-
Pour insérer un seul document, entrez les informations suivantes :
db.collection.insert({"hello":"DocumentDB"})
-
Vous obtenez le résultat suivant :
WriteResult({ "nInserted" : 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" }
-
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" : [ 1, 2, 3, 4 ] }
-
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 5.
-
Utilisez une requête pour un seul document à l'aide d'un filtre. Entrez les informations suivantes :
db.profiles.find({name: "Katie"})
-
Vous devriez récupérer cette sortie :
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
-
Essayons maintenant de trouver un profil et de le modifier à l'aide de la
findAndModify
commande. Nous allons donner dix points supplémentaires à l'utilisateur Matt 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 }
-
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 5 : Explorez
Félicitations ! Vous avez terminé avec succès le guide de démarrage d'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 :
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.