Utilisation de l'API MongoDB avec Oracle Autonomous Database on Dedicated Exadata Infrastructure

L'API Oracle Database pour MongoDB convertit le protocole de connexion MongoDB en instructions SQL exécutées par Oracle Database. Il permet aux développeurs disposant d'ensembles de compétences MongoDB d'écrire des applications de banque de documents JSON pour Oracle Database qui utilisent des pilotes et des outils qui comprennent le protocole MongoDB. Pour obtenir une présentation détaillée de cette API, reportez-vous à Présentation de l'API Oracle Database pour MongoDB dans API Oracle Database pour MongoDB.

Activer l'API MongoDB

Vous pouvez activer l'API MongoDB pour une instance Autonomous Database à partir de la console OCI ou manuellement à l'aide d'Oracle REST Data Services (ORDS).

Pour utiliser l'API MongoDB avec une instance Autonomous Database, vous devez installer et configurer Oracle REST Data Services (ORDS) géré par le client séparément, et la version d'ORDS doit être 22.3 ou ultérieure. Pour connaître les concepts architecturaux de cette API, reportez-vous à Oracle API for MongoDB Support dans le Guide d'installation et de configuration d'Oracle REST Data Services.

Pour activer l'API MongoDB à partir de la console OCI, procédez comme suit :
  • Sur la page Détails d'Autonomous Database, sélectionnez l'onglet Configuration de l'outil.
  • Cliquez sur Modifier la configuration d'outil.
  • Dans la ligne de l'API MongoDB, sélectionnez l'option Activer l'outil pour afficher Activé.
  • Cliquez sur Appliquer.
L'état du cycle de vie passe à mise à jour jusqu'à ce que MongoDB soit activé.

Vous pouvez également activer l'API MongoDB lorsque vous provisionnez ou clonez une instance en sélectionnant Afficher les options avancées et en sélectionnant l'onglet Outils.

Pour activer MongoDB manuellement, procédez comme suit :

Pour une démonstration des étapes ci-dessus, reportez-vous à la section Getting Started in Oracle REST Data Services Installation and Configuration Guide.

Connecter les applications MongoDB

Une fois l'API MongoDB activée, vous pouvez créer un utilisateur MongoDB et vous connecter à Autonomous Database avec sa chaîne de connexion.

Avec la chaîne de connexion d'API MongoDB, vous pouvez utiliser le shell MongoDB, qui est un utilitaire de ligne de commande, pour vous connecter et interroger vos données.

Vous pouvez extraire sa chaîne de connexion à partir de la console Oracle Cloud Infrastructure. Pour extraire la chaîne de connexion à l'API MongoDB, procédez comme suit :
  1. Sur la page Détails d'Autonomous Database, sélectionnez l'onglet Configuration de l'outil.
  2. Sur la ligne API MongoDB, sous URL d'accès, cliquez sur Copier.

Si vous utilisez l'API MongoDB sur Autonomous Database sur Exadata Cloud@Customer, votre équipe réseau/DNS doit s'assurer que tout nom d'hôte de chaîne de connexion MongoDB est résolu sur le SCAN du cluster. Sans cela, les clients MongoDB ne pourront pas se connecter à la base de données. Vous pouvez autoriser les connexions à toutes les bases de données Autonomous Database du cluster à l'aide d'un enregistrement DNS générique ou autoriser une instance Autonomous Database spécifique :

Tester les connexions MongoDB

Création d'un utilisateur Autonomous Database de test pour MongoDB

Vous pouvez créer un utilisateur de test, ou un utilisateur authentifié de manière similaire, à des fins de test.

  1. Ouvrez la console OCI pour votre instance Autonomous Database.
  2. Cliquez sur Database Actions.
  3. Dans la fenêtre de lancement Database Actions, cliquez sur Administration > Utilisateurs de base de données.
  4. Cliquez sur + Créer un utilisateur sur la page Utilisateurs de base de données.
  5. Entrez un nom d'utilisateur et un mot de passe pour l'utilisateur de test. Cliquez sur Accès Web, puis définissez le quota sur le tablespace DATA.
  6. Cliquez sur l'onglet Rôles accordés.
  7. Outre les rôles par défaut, sélectionnez et ajoutez le rôle SODA_APP pour l'utilisateur.
  8. Cliquez sur Créer un utilisateur.

Tester la connexion à l'aide de la ligne de commande

  1. Connectez-vous en tant qu'utilisateur de test. Suivez les étapes de l'exemple précédent pour obtenir des instructions.
    $ 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
    > 

    Remarques :

    Utilisez l'encodage de pourcentage 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 codage en 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#?, la 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 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 de coder les caractères réservés qu'ils contiennent.

    Voir aussi :

  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;

Test de la connexion à l'aide d'une application Node.js

  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. Configuration de 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);
      

      Remarques :

      Utilisez l'encodage de pourcentage 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 codage en 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#?, la 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 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 de coder les caractères réservés qu'ils contiennent.

      Voir aussi :

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