Uso de la API de Oracle Database para MongoDB

Para utilizar la API MongoDB, puede crear y configurar una nueva base de datos de IA autónoma o modificar la configuración de una base de datos de IA autónoma existente mediante la configuración de ACL o la definición de un punto final privado.

Configuración de una nueva base de datos de IA autónoma para MongoDB

Siga los pasos de Aprovisionamiento o clonación de una base de datos de IA autónoma hasta el punto en el que seleccione su tipo de acceso de red.

Descripción de la ilustración adb_network_access_acl_provision.png

En este punto, para utilizar Oracle Database API for 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 base de datos de IA autónoma con un punto final privado.

Configuración de una base de datos de IA autónoma existente para MongoDB

Abra la consola de Oracle Cloud Infrastructure para su instancia de base de datos de IA autónoma.

Descripción de la ilustración adb_ajd_console_details.png

Nota

Para utilizar Oracle Database API for MongoDB, la red debe estar configurada y el tipo de acceso debe ser: Acceso seguro solo desde IP permitidas y VCN o Acceso solo a punto final privado.

Después de configurar el acceso de red para la instancia de base de datos de IA autónoma, active la API MongDB.

1. En la página de detalles de Autonomous AI Database, seleccione el separador Configuración de herramienta.
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 AI Database, seleccione el separador Configuración de herramienta.
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

• Recuperación de la cadena de conexión de la base de datos de IA autónoma desde Database Actions
  

1. Conéctese como usuario de prueba. Consulte Creación de un usuario de prueba de Autonomous Database 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 reemplazar cualquier carácter reservado en su URI de cadena de conexión, en particular, los caracteres en su nombre de usuario y contraseña. Estos son los caracteres reservados y sus codificaciones porcentuales:

   !	#	$	%	&	'	(	)	*	+
   %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 URI. En ese caso, es probable que no necesite codificar los caracteres reservados que contienen.

   Consulte también lo siguiente:

   • Porcentaje de codificación - Caracteres reservados

   • Identificador de Recursos Uniforme (URI): Sintaxis Genérica

2. Cree una recopilación e inserte documentos en la recopilación.

   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. Consultar 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. Configuración de 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 su conexión con un ejemplo de Javascript.
   1. Crear Nuevo Directorio.

      $ mkdir autonomous_mongodb
      $ cd autonomous_mongodb
      $ npm init –y

   2. Instale la dependencia de 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 reemplazar cualquier carácter reservado en su URI de cadena de conexión, en particular, los caracteres en su nombre de usuario y contraseña. Estos son los caracteres reservados y sus codificaciones porcentuales:

      !	#	$	%	&	'	(	)	*	+
      %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 URI. En ese caso, es probable que no necesite codificar los caracteres reservados que contienen.

      Consulte también lo siguiente:

      • Porcentaje de codificación - Caracteres reservados

      • Identificador de Recursos Uniforme (URI): Sintaxis Genérica

   4. Ejecute el ejemplo. La salida debe tener un aspecto similar al siguiente.

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