Utilisation de l'API Oracle Database pour MongoDB

Pour utiliser l'API MongoDB, vous pouvez créer et configurer une nouvelle base de données d'IA autonome ou modifier la configuration d'une base de données d'IA autonome existante en configurant des listes de contrôle d'accès ou en définissant un point d'extrémité privé.

Configurer une nouvelle base de données d'IA autonome pour MongoDB

Suivez les étapes sous Provisionner ou cloner une base de données d'IA autonome, jusqu'au point où vous sélectionnez votre type d'accès au réseau.

Description de l'illustration adb_network_access_acl_provision.png

À ce stade, pour utiliser Oracle Database API for 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é depuis les adresses IP et les réseaux en nuage virtuels autorisés seulement

• Accès au point d'extrémité privé seulement

  Voir Configurer l'accès réseau à l'aide de points d'extrémité privés pour plus d'informations sur la configuration d'une instance de base de données autonome avec un point d'extrémité privé.

Configurer une base de données d'IA autonome existante pour MongoDB

Ouvrez la console Oracle Cloud Infrastructure pour votre instance de base de données du service d'intelligence artificielle autonome.

Description de l'illustration adb_ajd_console_details.png

Note

Pour utiliser l'API Oracle Database API for 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 en nuage virtuels autorisés uniquement ou Accès aux points d'extrémité privés uniquement.

Après avoir configuré l'accès réseau pour l'instance de base de données du service d'intelligence artificielle autonome, activez l'API MongDB.

1. Dans la page des détails de la base de données d'intelligence artificielle autonome, sélectionnez l'onglet Configuration des outils.
2. Cliquez sur Modifier la configuration de l'outil.
3. Dans la rangée de l'API MongoDB, sélectionnez dans la colonne Activer l'outil l'option Activé.
4. Cliquez sur Appliquer.

1. Dans la page des détails de la base de données d'intelligence artificielle autonome, sélectionnez l'onglet Configuration des outils.
2. Dans la rangée de l'API MongoDB, sous URL d'accès, cliquez sur Copier.

Description de l'illustration adb_tools_mongo_connect_string.png

• Extraire la chaîne de connexion à la base de données du service d'intelligence artificielle autonome à partir de Database Actions
  

1. Connectez-vous en tant qu'utilisateur test. Pour plus d'informations, voir Créer 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
   > 

   Note
   
   

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

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

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

   Par exemple, si votre nom d'utilisateur est RUTH et que votre mot de passe est @least1/2#?, la chaîne de connexion MongoDB au serveur <server> peut ressembler à ceci :

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

   Selon les outils ou les pilotes que vous utilisez, vous pouvez fournir un nom d'utilisateur et un mot de passe en tant que paramètres distincts, au lieu de faire partie 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 (Uniform Resource Identifier) : Syntaxe générique

2. Créez une collection et insérez des documents dans votre collection.

   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. Extraire 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 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);
      

      Note
      
      

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

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

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

      Par exemple, si votre nom d'utilisateur est RUTH et que votre mot de passe est @least1/2#?, la chaîne de connexion MongoDB au serveur <server> peut ressembler à ceci :

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

      Selon les outils ou les pilotes que vous utilisez, vous pouvez fournir un nom d'utilisateur et un mot de passe en tant que paramètres distincts, au lieu de faire partie 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 (Uniform Resource Identifier) : Syntaxe générique

   4. Exécutez l'exemple suivant. 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' ]
      }