Pour utiliser l'API MongoDB, vous pouvez créer et configurer une instance Autonomous Database ou modifier la configuration d'une instance Autonomous Database existante en configurant des listes de contrôle d'accès ou en définissant une adresse privée.

Configuration d'une nouvelle instance Autonomous Database pour MongoDB

Suivez les étapes décrites dans Provisionnement ou clonage d'une instance Autonomous Database, jusqu'au point où vous sélectionnez votre type d'accès réseau.

Description de l'illustration adb_network_access_acl_provision.png

A ce stade, pour utiliser l'API Oracle Database pour MongoDB, configurez l'accès sécurisé en sélectionnant et en configurant l'un des types d'accès réseau suivants :

• Accès sécurisé à partir des adresses IP et des réseaux cloud virtuels autorisés uniquement

• Accès à l'adresse privée uniquement

  Pour plus d'informations sur la configuration d'une instance Autonomous Database avec une adresse privée, reportez-vous à Configuration de l'accès réseau avec des adresses privées.

Configuration d'une base de données Autonomous Database existante pour MongoDB

Ouvrez la console Oracle Cloud Infrastructure pour votre instance Autonomous Database.

Description de l'image adb_ajd_console_details.png

Remarque

Afin d'utiliser l'API Oracle Database pour MongoDB, le réseau doit être configuré et le type d'accès doit être : Accès sécurisé à partir des adresses IP et des réseaux cloud virtuels autorisés uniquement ou Accès à l'adresse privée uniquement.

Une fois que vous avez configuré l'accès réseau pour l'instance Autonomous Database, activez l'API MongDB.

1. Sur la page de détails de l'instance Autonomous Database, sélectionnez l'onglet Configuration d'outil.
2. Cliquez sur Modifier la configuration d'outil.
3. Dans la ligne d'API MongoDB, sélectionnez Activer l'outil dans la colonne Activé.
4. Cliquez sur Appliquer.

1. Sur la page de détails de l'instance Autonomous Database, sélectionnez l'onglet Configuration d'outil.
2. Sur la ligne d'API MongoDB, sous URL d'accès, cliquez sur Copier.

Description de l'image adb_tools_mongo_connect_string.png

• Extraction de la chaîne de connexion Autonomous Database à partir de Database Actions
  

1. Connectez-vous en tant qu'utilisateur de test. Pour plus d'informations, reportez-vous à Création d'un utilisateur Autonomous Database de test pour MongoDB.

   $ mongosh --tls --tlsAllowInvalidCertificates 'mongodb://TESTUSER:<PASSWORD>@<database URL>.
   <OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false'
   Current Mongosh Log ID: 614c9e2a01e3575c8c0b2ec7
   Connecting to:         mongodb://TESTUSER:<PASSWORD>@<database URL>.<OCIregion>.oraclecloudapps.com:27017/admin?
   authMechanism=PLAIN&authSource=$external&tls=true&loadBalanced=false
   Using MongoDB:                   3.6.2
   Using Mongosh:                   1.0.7
   For mongosh info see: https://docs.mongodb.com/mongodb-shell/admin
   > show dbs
   testuser    0 B
   > 

   Remarque
   
   

   Utilisez l'encodage de pourcentage d'URI pour remplacer les caractères réservés dans l'URI de la chaîne de connexion, notamment les caractères du nom utilisateur et du mot de passe. Voici les caractères réservés et leur encodage de pourcentage :

   !	#	$	%	&	'	(	)	*	+
   %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

   ,	/	:	;	=	?	@	[	]
   %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

   Par exemple, si votre nom utilisateur est RUTH et que votre mot de passe est @least1/2#?, votre chaîne de connexion MongoDB au serveur <server> peut se présenter comme suit :

   'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

   Selon les outils ou pilotes que vous utilisez, vous pouvez fournir un nom utilisateur et un mot de passe en tant que paramètres distincts, plutôt que dans le cadre d'une chaîne de connexion URI. Dans ce cas, vous n'aurez probablement pas besoin d'encoder les caractères réservés qu'ils contiennent.

   Voir aussi :

   • Encodage en pourcentage - Caractères réservés

   • URI : syntaxe générique

2. Créer une collection et y insérer des documents.

   testuser> show collections
   
   testuser> db.createCollection( 'fruit' )
   { ok: 1 }
   testuser> show collections
   fruit
   testuser> db.fruit.insertOne( {name:"orange", count:42} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca31fdab254f63e4c6b47")
   }
   testuser> db.fruit.insertOne( {name:"apple", count:12, color: "red"} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca340dab254f63e4c6b48")
   }
   testuser> db.fruit.insertOne( {name:"pear", count:5} )
   {
     acknowledged: true,
     insertedId: ObjectId("614ca351dab254f63e4c6b49")
   }
   testuser>

3. Interrogez la collection à l'aide d'un client SQL tel que Database Actions.

   SELECT
        f.json_document.name, 
        f.json_document.count, 
        f.json_document.color
   FROM fruit f;

   
   Description de l'illustration database_actions_sql_for_mongodb_use.png

1. Téléchargez Node.js. Si vous avez déjà téléchargé ou installé Node.js pour votre environnement, vous pouvez ignorer cette étape.

   $ wget https://nodejs.org/dist/latest-v14.x/node-v14.17.5-linux-x64.tar.xz

2. Extrayez le contenu de l'archive Node,js. Si vous avez déjà téléchargé ou installé Node.js pour votre environnement, vous pouvez ignorer cette étape.

   $ tar -xf node-v14.17.5-linux-x64.tar.xz

3. Configurez la variable d'environnement PATH. Si vous avez déjà téléchargé ou installé Node.js pour votre environnement, vous pouvez ignorer cette étape.

   $ export PATH="`pwd`"/node-v14.17.5-linux-x64/bin:$PATH

4. Testez votre connexion avec un exemple de Javascript.
   1. Créer un répertoire.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Installez la dépendance MongoDB.

      $ npm install mongodb

   3. Créez une application JavaScript nommée connect.js.

      const { MongoClient } = require("mongodb");
      const uri =
         "mongodb://TESTUSER:<PASSWORD>@<Database URI>.<OCI region>.oraclecloudapps.com:27017/admin?authMechanism=PLAIN&authSource=$external&ssl=true&loadBalanced=false";
      
      const client = new MongoClient(uri);
      
      async function run() {
        try {
              await client.connect();
      
              const database = client.db('admin');
              const movies = database.collection('movies');
      
              // Insert a movie
              const doc = { title: 'Back to the Future', 
                            year: 1985, genres: ['Adventure', 'Comedy', 'Sci-Fi'] }
              const result = await movies.insertOne(doc);
      
              // Query for a movie that has the title 'Back to the Future' :)
              const query = { title: 'Back to the Future' };
              const movie = await movies.findOne(query);
      
              console.log(movie);
        } finally {
           // Ensures that the client will close when you finish/error
           await client.close();
        }
      }
      run().catch(console.dir);
      

      Remarque
      
      

      Utilisez l'encodage de pourcentage d'URI pour remplacer les caractères réservés dans l'URI de la chaîne de connexion, notamment les caractères du nom utilisateur et du mot de passe. Voici les caractères réservés et leur encodage de pourcentage :

      !	#	$	%	&	'	(	)	*	+
      %21	%23	%24	%25	%26	%27	%28	%29	%2A	%2B

      ,	/	:	;	=	?	@	[	]
      %2C	%2F	%3A	%3B	%3D	%3F	%40	%5B	%5D

      Par exemple, si votre nom utilisateur est RUTH et que votre mot de passe est @least1/2#?, votre chaîne de connexion MongoDB au serveur <server> peut se présenter comme suit :

      'mongodb://RUTH:%40least1%2F2%23%3F@<server>:27017/ruth/ ...'

      Selon les outils ou pilotes que vous utilisez, vous pouvez fournir un nom utilisateur et un mot de passe en tant que paramètres distincts, plutôt que dans le cadre d'une chaîne de connexion URI. Dans ce cas, vous n'aurez probablement pas besoin d'encoder les caractères réservés qu'ils contiennent.

      Voir aussi :

      • Encodage en pourcentage - Caractères réservés

      • URI : syntaxe générique

   4. Exécuter l'exemple. La sortie doit ressembler à ce qui suit.

      $ node connect
      {
        _id: new ObjectId("611e3266005202371acf27c1"),
        title: 'Back to the Future',
        year: 1985,
        genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ]
      }