Uso de la API de Oracle Database para MongoDB
Oracle Database API for MongoDB makes it possible to connect to Oracle Autonomous Database using MongoDB language drivers and tools.
La API de Oracle Database para MongoDB utiliza las capacidades de las bases de datos convergentes de una instancia de Autonomous Database para gestionar varios tipos de datos, incluidos los datos JSON, en una sola base de datos. Por ejemplo, estas capacidades de base de datos convergente permiten utilizar SQL para consultar o actualizar los datos de JSON.
Consulte API de Oracle Database para obtener más información sobre MongoDB.
Consulte Acerca de Autonomous JSON Database para obtener más información.
Consulte Acerca de los tipos de carga de trabajo de Autonomous Database para obtener más información.
- Configure Access for MongoDB and Enable MongoDB
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store. - User Management for MongoDB
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store. Si desea o necesita utilizar una instancia de Autonomous Database existente para este fin, aquí está el flujo de trabajo. - Creación de un usuario de Autonomous Database de prueba para MongoDB
- Conexión de aplicaciones MongoDB a Autonomous Database
La conexión de la aplicación MongoDB a Autonomous Database incluye varios pasos, según sus requisitos.
Tema principal: Desarrollo
Configuración del acceso para MongoDB y activación de MongoDB
Para utilizar la API MongoDB, puede crear y configurar una instancia de Autonomous Database nueva o modificar la configuración de una instancia de Autonomous Database existente. MongoDB necesita que configure el acceso de red para utilizar ACL o que defina un punto final privado para la instancia de Autonomous Database. Además de configurar el acceso de red, debe activar la API MongoDB en la instancia de Autonomous Database.
- Configuración de acceso para MongoDB
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. - Activación de la API MongoDB en Autonomous Database
Después de configurar el acceso de red para la instancia de Autonomous Database, active la API MongDB.
Tema principal: Uso de la API de Oracle Database para MongoDB
Configuración del acceso para MongoDB
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.
![A continuación se muestra la descripción de adb_network_access_acl_provision.png A continuación se muestra la descripción de adb_network_access_acl_provision.png](img/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 adb_ajd_console_details.png Descripción de adb_ajd_console_details.png](img/adb_ajd_console_details.png)
Para utilizar la API de Oracle Database para MongoDB, la red debe estar configurada y el tipo de acceso debe ser: Permitir acceso seguro desde IP y redes virtuales en la nube especificadas o Red virtual en la nube.
Configuración de listas de control de acceso (ACL)
Consulte Configuración de listas de control de acceso para una instancia de Autonomous Database existente para obtener más información.
-
En el área Seleccionar acceso de red, haga clic en Agregar mi dirección IP. De esta forma, se copia la dirección IP en el campo Valores.
- Después de desactivar cualquier VPN, utilice el sitio web WhatIsMyIP.
- Después de desactivar cualquier VPN, utilice el comando curl:
curl -s https://ifconfig.me
.
Las direcciones IP públicas pueden cambiar. Cualquier cambio en su dirección IP pública requerirá un cambio en la ACL. Si no puede acceder a la base de datos, la ACL debe ser algo que comprobar.
Tipos y casos de uso de ACL
Tipo de ACL | Ejemplo | Comentario |
---|---|---|
Dirección IP | Equipos portátiles de desarrollo local que comparten la misma dirección IP pública | La forma más fácil de empezar. Cualquier equipo portátil conectado en esta LAN tendrá acceso a la base de datos con las credenciales de la base de datos. |
Bloque de CIDR | Portátil de desarrollo local | Uso de la notación IPv4/32 |
Direcciones IP separadas por comas | Pequeña cantidad de portátiles de desarrollo local conectados en distintas LAN (con distintas direcciones IP públicas) | Puede ser tedioso trabajar con más de 10 portátiles. |
Bloque de CIDR | Portátiles de desarrollo local conectados en la misma subred expuesta a Internet (cada portátil tiene su propia dirección IP pública) | Confíe en la notación de bloque CIDR. Consulte la calculadora aquí para obtener más información. Ejemplo: 89.84.109.0/24 proporciona 256 direcciones IP posibles de la 89.84.109.0 a la 89.84.109.255 |
VCN con bloque de CIDR | Para pruebas, producción o el pipeline de integración y despliegue continuos alojado en OCI que tenga sus propias instancias de VCN e informáticas | Asigne el compartimento de OCI por tipo de entorno. |
Combinación de dirección IP y VCN con bloque CIDR | Equipo portátil de desarrollo local que accede a una instancia de Autonomous Database de prueba con conexiones desde el entorno de prueba o el pipeline de integración y despliegue continuos | Opción de configuración común para el trabajo de desarrollo en curso. |
Tema principal: Configuración del acceso para MongoDB y activación de MongoDB
Activación de la API MongoDB en Autonomous Database
Después de configurar el acceso de red para la instancia de Autonomous Database, active la API MongDB.
Para activar la API MongoDB para una instancia existente:
- En la página de detalles de Autonomous Database, seleccione el separador Configuración de herramientas.
- Haga clic en Editar configuración de herramienta.
- En la fila de API MongoDB, seleccione la columna Activar herramienta para mostrar Activado.
- Haga clic en Aplicar.
El estado del ciclo de vida cambia a la actualización hasta que se activa MongoDB.
También puede activar la API MongoDB al aprovisionar o clonar una instancia seleccionando Mostrar opciones avanzadas y seleccionando el separador Herramientas.
Consulte Gestión de las herramientas incorporadas de Autonomous Database para obtener más información.
Tema principal: Configuración del acceso para MongoDB y activación de MongoDB
Gestión de usuarios para MongoDB
Oracle Database API for MongoDB enables you to use an Oracle Autonomous Database as the data store. Si desea o necesita utilizar una instancia de Autonomous Database existente para este fin, aquí está el flujo de trabajo.
La API de Oracle Database para MongoDB permite la asignación de objetos de Autonomous Database a objetos MongoDB de la siguiente forma:
Objeto MongoDB | Objeto de Oracle Autonomous Database |
---|---|
Base de Datos | Esquema |
recopilación | tabla |
Documento | documento (en una columna) |
Por ejemplo, podría crear una recopilación mediante la API de Oracle Database para MongoDB de la siguiente forma:
use scott;
db.createCollection('fruit');
Se crea una tabla denominada FRIT en el esquema SCOTT.
Al conectarse a la API de Oracle Database para MongoDB, se autentica mediante un nombre de usuario y una contraseña de Autonomous Database. Esta conexión autenticada a continuación accede a las recopilaciones del esquema correspondiente. Este usuario debe cumplir los siguientes requisitos:
- El esquema del usuario debe estar activado para ORDS, lo que a veces se denomina activado para acceso web. Consulte Configuración básica para activar la API de base de datos de ORDS para obtener más información.
- El usuario debe tener los siguientes roles y privilegios:
SODA_APP
,CREATE TABLE
yCREATE SESSION
. Consulte Gestión de privilegios y roles de usuario en Autonomous Database para obtener más información. - El usuario tiene una cuota en el tablespace DATA. See Create Users on Autonomous Database for more information.
El rol
DWROLE
de Autonomous Database contiene estos roles, entre otros.
El acceso a los esquemas no otorgados al usuario está prohibido. Por ejemplo, el usuario SCOTT solo puede acceder a recopilaciones del esquema SCOTT. Hay una excepción. Si el usuario autenticado tiene los privilegios de Autonomous Database CREATE USER
, ALTER USER
y DROP USER
, ese usuario puede acceder a cualquier esquema activado para ORDS.
Además, un usuario con estos privilegios puede crear esquemas de forma implícita. Es decir, cuando el usuario crea una colección en una base de datos que no existe, el esquema se creará automáticamente. Consulte API de Oracle Database para obtener más información sobre MongoDB.
Tema principal: Uso de la API de Oracle Database para MongoDB
Creación de un usuario de Autonomous Database de prueba para MongoDB
Tema principal: Uso de la API de Oracle Database para MongoDB
Conexión de aplicaciones MongoDB a Autonomous Database
La conexión de la aplicación MongoDB a Autonomous Database incluye varios pasos, según sus requisitos.
- Recuperación de la cadena de conexión MongoDB de Autonomous Database
Puede recuperar la cadena de conexión de API MongoDB de la consola de Oracle Cloud Infrastructure. - Prueba de la conexión mediante la línea de comandos
- Prueba de la conexión mediante una aplicación Node.js
Tema principal: Uso de la API de Oracle Database para MongoDB
Recuperación de la cadena de conexión MongoDB de Autonomous Database
Después de obtener la cadena de conexión de API MongoDB, puede utilizar el shell MongoDB, que es una utilidad de línea de comandos, para conectar y consultar los datos.
Primero debe configurar el acceso de red y activar la API MongoDB. Consulte Configuración del acceso para MongoDB para obtener más información.
Para recuperar la cadena de conexión de API MongoDB:
- En la página de detalles de Autonomous Database, seleccione el separador Configuración de herramientas.
- En la fila de API MongoDB, en URL de acceso, haga clic en Copiar.
![A continuación se muestra la descripción de adb_tools_mongo_connect_string.png A continuación se muestra la descripción de adb_tools_mongo_connect_string.png](img/adb_tools_mongo_connect_string.png)