Configurar la conexión entre MongoDB Atlas y Compass es el paso fundamental para comenzar a trabajar con bases de datos NoSQL de forma local. Desde la creación de usuarios con roles específicos hasta la inserción del primer documento, este proceso sienta las bases para cualquier proyecto que utilice MongoDB en la nube.
¿Cómo crear un usuario de acceso en MongoDB Atlas?
Antes de conectar cualquier herramienta a tu base de datos, necesitas generar credenciales de acceso. En el menú lateral de Atlas, dentro de Database Access, puedes crear un nuevo usuario [01:00]. El nombre puede ser el que prefieras, y la contraseña puede ser personalizada o generada automáticamente como contraseña segura.
Una vez definidas las credenciales, debes asignar roles al usuario. Los roles determinan qué operaciones puede realizar sobre la base de datos:
- Read and write to any database: permite leer y escribir en cualquier base de datos.
- Atlas admin: otorga control total, ideal para entornos de prueba [01:38].
- Roles personalizados: MongoDB también permite crearlos según necesidades específicas.
Es importante copiar la contraseña antes de continuar, ya que será necesaria para construir la URI de conexión.
¿Por qué configurar el acceso de red en Atlas?
Que tu base de datos esté en la nube no significa que cualquier persona deba conectarse a ella. En la sección Network Access puedes controlar qué direcciones IP tienen permiso de conexión [02:16].
Por defecto, Atlas puede mostrar una IP abierta a todo internet, pero la buena práctica es agregar únicamente las IPs de tus servidores, instancias y computadoras locales. Atlas facilita esto con un botón que detecta tu IP actual automáticamente [03:02], sin necesidad de buscarla en sitios externos.
Para configuraciones más avanzadas existen opciones como:
- Peering: conectar Atlas con otros proveedores de nube como AWS, Azure o Google Cloud Platform.
- Private endpoints: conexiones privadas para mayor seguridad.
¿Cómo generar la conexión desde Compass?
Desde la sección Database en Atlas, al hacer clic en Connect, aparecen varias opciones: drivers, la mongo CLI (shell), e incluso Atlas SQL para herramientas basadas en SQL [03:47]. Para este caso se utiliza Compass.
Atlas genera una URI de conexión con el formato mongodb+srv://, seguida del nombre de usuario, la contraseña y el dominio del cluster o replica set [04:14]. Esta URI se pega directamente en Compass al crear una nueva conexión.
Al guardar la conexión, Compass permite asignar un nombre y un color. El color es una práctica útil para distinguir visualmente entre entornos de producción, desarrollo y QA [04:47].
¿Cómo crear una base de datos y una colección?
Una vez conectado, Compass muestra tres bases de datos internas que MongoDB utiliza para operaciones propias. Para crear una nueva, basta con definir un nombre y una colección [05:27]. En MongoDB, las colecciones equivalen a las tablas en bases de datos relacionales; el nombre cambia, pero el concepto es similar.
¿Cómo insertar un documento en MongoDB Compass?
Dentro de la colección, puedes importar datos desde un JSON o CSV, o insertar documentos individualmente. Al insertar, se abre un editor similar a un archivo JSON donde el identificador (_id) ya viene definido automáticamente [06:02].
Un documento puede contener múltiples tipos de datos:
- Strings: campos de texto como nombre y apellido.
- Arrays: listas de valores, como roles de usuario (
admin, analytics) [06:48].
- Date: fechas declaradas con el operador
$date, precedido siempre por el signo monetario que caracteriza a los operadores de MongoDB [07:12].
- Números: valores numéricos como la edad, que no llevan comillas.
El editor marca errores en tiempo real si faltan comillas, comas o hay problemas de formato [07:52]. Una vez insertado, el documento queda disponible inmediatamente.
¿Qué sigue después de crear tu primer documento?
MongoDB cuenta con un intérprete de JavaScript que permite realizar operaciones más allá de la interfaz gráfica [08:18]. Una forma práctica de poblar tu base de datos es utilizar herramientas de inteligencia artificial para generar múltiples documentos con un esquema definido, e importarlos mediante JSON o CSV directamente desde Compass.
¿Ya lograste conectar tu base de datos? Comparte tu experiencia o las dudas que te surgieron durante el proceso.
