El Connect El cuadro de diálogo para un clúster proporciona los detalles para conectarse a un clúster a través del shell de MongoDB. mongosh.
Requisitos previos
TLS
Los clientes deben admitir TLS para conectarse a un clúster de Atlas.
Los clientes deben apoyar el SNIExtensión TLS para conectarse a un M0 clúster Atlas Free o Flex. El shell de MongoDB admite la extensión TLS de SNI.
Lista de acceso IP
Para acceder a un clúster, debe conectarse desde una dirección IP de la lista de acceso IP del proyecto Atlas. Si necesita agregar una dirección IP a la lista de acceso IP, puede hacerlo en el cuadro de diálogo Connect. También puede agregar la dirección IP desde Pestaña Acceso a red.
Usuario de base de datos
Para acceder a un clúster, debe crearse un usuario de base de datos con acceso a las bases de datos deseadas en el clúster de Atlas. Los usuarios de base de datos son distintos de los usuarios de Atlas. Los usuarios de bases de datos tienen acceso a las bases de datos de MongoDB, mientras que los usuarios de Atlas tienen acceso a la aplicación Atlas en sí.
Es posible crear un usuario de base de datos para acceder al clúster de Atlas en el cuadro de diálogo Connect. También se puede añadir el usuario de base de datos desde la vista del clúster.
Conéctate a tu clúster
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Elija la seguridad de su conexión.
Choose Connection Type del conjunto de botones disponibles.
Nota
Mostrar opciones si la característica está activada
Atlas muestra las opciones de tipo de conexión después de habilitar IP privada para emparejamiento, nodos privados, o ambos. Si no has habilitado ninguna de las dos características, no se mostrarán botones y Connection Type se establecerá por defecto en Standard.
Utilice este tipo de conexión para las direcciones IP públicas autorizadas.
Utilizar este tipo de conexión si se ha habilitado el emparejamiento:
Para Google Cloud o Azure y se están conectando con {{connChoice}} desde una red de emparejamiento, o
Para AWS y se conectan con {{connChoice}} desde una red de emparejamiento que utiliza un servicio DNS personalizado.
Si ninguno de estos se aplica, agregue su dirección IP a su lista de acceso IP y utilice la cadena de conexión estándar. Si se conecta directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción de preferencia.
Nota
El emparejamiento debe estar disponible
No se puede seleccionar esta opción a menos que uno de los pares esté marcado como AVAILABLE. Para aprender cómo verificar el estado de los pares, consulta Ver conexiones peering de red de Atlas.
Nota
Clústeres multicloud
Si la aplicación no está alojada en el mismo proveedor de servicios de nube que el primario del clúster, la aplicación solo puede realizar lecturas secundarias.
Con clústeres multi-nube, se debe considerar agregar la opción de conexión readPreference a la cadena de conexión. Se deben usar uno de los siguientes valores:
Utilice la cadena de conexión para el punto final de la interfaz adecuada si se está conectando con {{connChoice}} a través de una conexión de punto final privado porque {{connChoice}}:
Se ejecuta dentro de la red de su proveedor de nube, o
Tiene acceso transitivo a la red del proveedor de nube.
Debe usarse una cadena de conexión optimizada.
Si ninguno de estos se aplica, se debe agregar la dirección IP a la lista de acceso IP y usar la cadena de conexión estándar. Si se realiza la conexión directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción preferida.
Nota
No puede seleccionar esta opción a menos que su conexión PrivateLink configurada esté lista para usar. Para aprender cómo verificar el estado de su AWS PrivateLink, consulte Solucionar problemas de conexión de nodos privados.
Elija cómo desea limitar las conexiones a tu clúster.
Add a Connection IP Address
Importante
Omite este paso si Atlas indica en el paso Setup connection security que ya se ha configurado una entrada de la lista de acceso IP en el clúster. Para gestionar la lista de acceso IP, se debe consultar Agregar entradas a la lista de acceso.
Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas le solicita añadir una dirección IP a la lista de acceso IP del proyecto. Puede hacerse:
Se debe hacer clic en Add Your Current IP Address para permitir el acceso desde tu dirección IP actual.
Haz clic en Add an IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
Add a Connection IP Address
Importante
Omita este paso si Atlas indica en el paso Setup connection security que ya ha configurado una entrada de la lista de acceso IP en su clúster. Para gestionar la lista de acceso IP, consulte Agregar entradas a la lista de acceso IP.
Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas solicitará agregar una dirección IP a la lista de acceso IP del proyecto. Haz clic en Add a Different IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
En Choose Connection Type, selecciona Private Endpoint.
Si se ven las opciones Private Link Type, seleccionar una de las siguientes opciones:
Optimized SRV Connection para conexiones equilibradas.
Legacy SRV Connection para conexiones no balanceadas.
Para obtener más información, consulta ¿Cómo puedo optimizar el rendimiento de la conexión para clústeres particionados mediante nodos privados?.
En Choose Private Endpoint, selecciona el endpoint que desea usar.
Cree un usuario de base de datos.
Importante
Omita este paso si Atlas indica en el paso Setup connection security que tiene al menos un usuario de base de datos configurado en su proyecto. Para gestionar los usuarios de base de datos existentes, consulte Configurar usuarios de base de datos.
Para acceder al clúster, necesita un usuario de MongoDB con acceso a la base de datos deseada en el clúster de su proyecto. Si su proyecto no tiene usuarios de MongoDB, Atlas le solicitará que cree un nuevo usuario con el rol de administrador de Atlas.
Introducir el Username del nuevo usuario.
Introduzca un Password para este nuevo usuario o haga clic en Autogenerate Secure Password.
Hacer clic en Create Database User para guardar al usuario.
Se debe usar este usuario para realizar la conexión al clúster en el siguiente paso.
Una vez que se haya añadido una dirección IP a la lista de acceso IP y un usuario de base de datos, se debe hacer clic en Choose Your Connection Method.
Conéctese a su clúster Atlas mongosh con.
Seleccione Shell.
La siguiente pantalla le ofrece opciones para proceder según si ya tiene mongosh instalado en su sistema o no.
Seleccione su sistema operativo en el menú desplegable.
Descargue utilizando una de las siguientes opciones:
Haz clic en Download mongosh para descargar.
Se debe hacer clic en Copy download URL para copiar una URL de descarga en el portapapeles, luego:
Utilice
curlpara obtener el archivo del instalador desde la URL, oPega la URL en una ventana del navegador.
Descarga el instalador desde la página de MongoDB Shell.
Extraiga los archivos del archivo comprimido descargado.
Agregue el binario
mongosha su variable de entornoPATH.Asegúrese de que el binario extraído de MongoDB Shell esté en la ubicación deseada de su sistema de archivos, luego añada esa ubicación a su variable de entorno
PATH.Abra el Control Panel.
En la categoría System and Security, haga clic en System.
Haz clic en Advanced system settings. Aparece el modal System Properties.
Haga clic en Environment Variables.
Seleccione Path y haga clic en Edit.
Haga clic en New y añada la ruta del archivo a su
mongoshbinario.El paso 3 del modal de Atlas muestra una cadena de conexión que se puede copiar. Este string incluye el nombre del usuario de MongoDB que puede autenticarse con el clúster. Copia este string. Para conectarte como un usuario diferente de MongoDB, cambia la opción --nombre de usuario.
Se debe pegar el comando
mongoshy la cadena de conexión en un terminal. Se debe ejecutar el comando. El shell pide la contraseña.
Usa el comando Homebrew proporcionado.
Copia el comando Homebrew de la ventana de la interfaz de usuario de Atlas y ejecútalo en un terminal.
El paso 3 del modal de Atlas muestra una cadena de conexión que se puede copiar. Este string incluye el nombre del usuario de MongoDB que puede autenticarse con el clúster. Copia este string. Para conectarte como un usuario diferente de MongoDB, cambia la opción --nombre de usuario.
Se debe pegar el comando
mongoshy la cadena de conexión en un terminal. Se debe ejecutar el comando. El shell pide la contraseña.
Descargue el instalador usando una de las siguientes opciones:
Haz clic en Download mongosh para descargar.
Se debe hacer clic en Copy download URL para copiar una URL de descarga en el portapapeles, luego:
Utilice
curlpara obtener el archivo del instalador desde la URL, oPega la URL en una ventana del navegador.
Descarga el instalador desde la página de MongoDB Shell.
Nota
El tipo de archivo que descargue depende del sistema operativo que haya seleccionado. Si selecciona una versión de:
Ubuntu o Debian se recibirá un paquete
.deb.RHEL, Amazon Linux o SUSE se recibe un paquete
.rpm.
Si su sistema operativo no está enumerado, consulte las instrucciones de instalación de .tgz en la documentación de
mongosh.Instale el paquete
mongosh.El paso 3 del modal de Atlas muestra una cadena de conexión que se puede copiar. Este string incluye el nombre del usuario de MongoDB que puede autenticarse con el clúster. Copia este string. Para conectarse como un usuario diferente de MongoDB, cambie la opción
--username.Se debe pegar el comando
mongoshy la cadena de conexión en un terminal. Se debe ejecutar el comando. El shell pide la contraseña.
Se debe seleccionar
mongoshen el menú desplegable. Recomendamos que se actualice a la versión más reciente del shell. Para comprobar la versión instalada demongosh, se debe ejecutar:mongosh --version El paso 2 del modal de Atlas muestra una cadena de conexión que se puede copiar e incluye el nombre del usuario de MongoDB que puede autenticarse con el clúster. Copia esta string. Para conectarse como un usuario diferente de MongoDB, cambia la opción --username.
Se debe pegar el comando
mongoshy la cadena de conexión en un terminal. Se debe ejecutar el comando. El shell pide la contraseña.
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.