Para utilizar la API MongoDB, puede crear y configurar una nueva instancia de Autonomous Database o modificar la configuración de una instancia de Autonomous Database existente mediante la configuración de ACL o la definición de un punto final privado.

Configuración de una nueva instancia de Autonomous Database para MongoDB

Siga los pasos de Aprovisionamiento o clonación de una instancia de Autonomous Database hasta el punto en el que debe seleccionar el tipo de acceso de red.

Descripción de la ilustración adb_network_access_acl_provision.png

En este punto, para utilizar la API de Oracle Database para MongoDB, configure el acceso seguro seleccionando y configurando uno de estos tipos de acceso de red:

• Acceso seguro solo desde direcciones IP y VCN permitidas

• Solo acceso de punto final privado

  Consulte Configuración del acceso de red con puntos finales privados para obtener información sobre la configuración de una instancia de Autonomous Database con un punto final privado.

Configuración de una instancia de Autonomous Database existente para MongoDB

Abra la consola de Oracle Cloud Infrastructure para su instancia de Autonomous Database.

Descripción de la ilustración adb_ajd_console_details.png

Nota

Para utilizar la API de Oracle Database para MongoDB, se debe configurar la red y el tipo de acceso debe ser: Acceso seguro solo desde IP y VCN permitidas o Solo acceso de punto final privado.

Después de configurar el acceso de red para la instancia de Autonomous Database, active la API MongDB.

1. En la página de detalles de Autonomous Database, seleccione el separador Configuración de herramientas.
2. Haga clic en Editar configuración de herramienta.
3. En la fila de API MongoDB, seleccione en la columna Activar herramienta para mostrar Activado.
4. Haga clic en Aplicar.

1. En la página de detalles de Autonomous Database, seleccione el separador Configuración de herramientas.
2. En la fila de API MongoDB, en URL de acceso, haga clic en Copiar.

Descripción de la ilustración adb_tools_mongo_connect_string.png

• Cómo recuperar la cadena de conexión de Autonomous Database de Database Actions
  

1. Conéctese como usuario de prueba. Consulte Creación de un usuario de Autonomous Database de prueba para MongoDB para obtener más información.

   $ 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
   > 

   Nota
   
   

   Utilice la codificación porcentual de URI para sustituir cualquier carácter reservado en el URI de cadena de conexión, en particular, los caracteres del nombre de usuario y la contraseña. Estos son los caracteres reservados y sus codificaciones de porcentaje:

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

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

   Por ejemplo, si el nombre de usuario es RUTH y la contraseña es @least1/2#?, la cadena de conexión MongoDB al servidor <server> podría tener este aspecto:

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

   Según las herramientas o los controladores que utilice, es posible que pueda proporcionar un nombre de usuario y una contraseña como parámetros independientes, en lugar de como parte de una cadena de conexión de URI. En ese caso, es probable que no necesite codificar ningún carácter reservado que contenga.

   Consulte también:

   • Codificación de porcentaje - Caracteres reservados

   • Identificador de recurso uniforme (URI): sintaxis genérica

2. Crear una colección e insertar documentos en ella.

   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. Consulte la recopilación mediante un cliente SQL como Database Actions.

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

   
   Descripción de la ilustración database_actions_sql_for_mongodb_use.png

1. Descargue Node.js. Si ya ha descargado o instalado Node.js para su entorno, puede omitir este paso.

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

2. Extraiga el contenido del archivo Node,js. Si ya ha descargado o instalado Node.js para su entorno, puede omitir este paso.

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

3. Configure la variable de entorno PATH. Si ya ha descargado o instalado Node.js para su entorno, puede omitir este paso.

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

4. Pruebe la conexión con un ejemplo de Javascript.
   1. Crear Nuevo Directorio.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Instale la dependencia mongodb.

      $ npm install mongodb

   3. Cree una aplicación JavaScript denominada 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);
      

      Nota
      
      

      Utilice la codificación porcentual de URI para sustituir cualquier carácter reservado en el URI de cadena de conexión, en particular, los caracteres del nombre de usuario y la contraseña. Estos son los caracteres reservados y sus codificaciones de porcentaje:

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

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

      Por ejemplo, si el nombre de usuario es RUTH y la contraseña es @least1/2#?, la cadena de conexión MongoDB al servidor <server> podría tener este aspecto:

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

      Según las herramientas o los controladores que utilice, es posible que pueda proporcionar un nombre de usuario y una contraseña como parámetros independientes, en lugar de como parte de una cadena de conexión de URI. En ese caso, es probable que no necesite codificar ningún carácter reservado que contenga.

      Consulte también:

      • Codificación de porcentaje - Caracteres reservados

      • Identificador de recurso uniforme (URI): sintaxis genérica

   4. Ejecutar ejemplo. La salida debe ser similar a la siguiente.

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