Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Conexión a un clúster mediante Librerías de clientes

La caja de diálogo Connect para un clúster proporciona los detalles para conectarse a un clúster con una aplicación mediante una librería de clientes de MongoDB.


➤ Utilice el menú desplegable Seleccione su lenguaje para establecer el idioma del ejemplo en esta página.


La versión de su driver debe ser compatible con su versión del servidor de MongoDB. Le recomendamos que elija el driver más reciente que sea compatible con la versión de su servidor MongoDB para utilizar las características más recientes de la base de datos y prepararse para futuras actualizaciones de la versión.

Para obtener una lista de las versiones de los drivers que contienen todas las funcionalidades para su versión del servidor MongoDB, consulte la Tabla de Compatibilidad de Librerías de clientes para su driver.

Importante

Driver oficialmente compatibles

Utiliza drivers de MongoDB compatibles oficialmente en las versiones actuales para obtener la mejor confiabilidad y experiencia de soporte. El SLA de Atlas solo cubre los drivers compatibles oficialmente.

Atlas proporciona soporte de diagnóstico, en la medida de lo posible, para Community drivers y versiones de driver que han llegado al final de su ciclo de vida. Atlas no prueba, parchea ni certifica los Community drivers. El servicio de soporte le ayuda a determinar si los problemas de conexión se originan en la plataforma o en el controlador, pero no depura el código del controlador.

Para aprender más, consulte ¿Cuál es la política de soporte de Atlas para los drivers de la Community y no compatibles?.

Es posible realizar la conexión al clúster particionado usando un driver y una cadena de conexión optimizada.

Los clientes deben admitir TLS para conectarse a un clúster de Atlas.

Los clientes deben admitir la extensión SNI de TLS para conectarse a un clúster Atlas Free (anteriormente conocido como M0) o a un clúster Flex.

Para acceder a un clúster, debes conectarte desde una dirección IP que esté en la lista de acceso IP del proyecto de Atlas. Si necesitas añadir una dirección IP a la lista de acceso IP, puedes hacerlo en el cuadro de diálogo Connect. También puedes agregar la dirección IP desde la pestaña Acceso a la red.

Para acceder a un clúster, debe tener 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í.

Puede crear un usuario de base de datos para acceder a su clúster de Atlas en el cuadro de diálogo Connect. También puede añadir el usuario de base de datos desde la vista del clúster. Atlas crea un usuario de base de datos cuando crea su primer clúster.

1
  1. 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.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2

Haz clic en Connect para el clúster al que deseas conectarte.

3

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.

4

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 de API, que restringe el acceso de 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.

  • Se debe hacer clic Add an IP Address para añadir 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.

5

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, necesitas un usuario de MongoDB con acceso a la base de datos o las bases de datos deseadas en el clúster de tu proyecto. Si tu proyecto no tiene usuarios de MongoDB, Atlas te invita a crear un usuario nuevo con el rol de Atlas Admin.

  1. Introducir el Username del nuevo usuario.

  2. Introduzca un Password para este nuevo usuario o haga clic en Autogenerate Secure Password.

  3. 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.

6

En el paso Choose a connection method, seleccione Drivers.

7

Seleccione su driver y la versión de los menús desplegables. Aparece la muestra del código que contiene una cadena de conexión. Sustituya <password> por la contraseña especificada cuando creó su usuario de base de datos.

En Use this connection string in your application, la cadena de conexión utiliza el formato SRV (mongodb+srv://) por defecto. Para ver la cadena de conexión estándar (no SRV) (mongodb://), desactive el interruptor SRV Connection String.

Nota

Si sus contraseñas, nombres de bases de datos o cadenas de conexión contienen caracteres URI reservados, debe reemplazar dichos caracteres. Por ejemplo, si su contraseña es @bc123, debe reemplazar el carácter @ al especificar la contraseña en la cadena de conexión, como %40bc123. Para obtener más información, consulte los Caracteres especiales en la contraseña de la cadena de conexión.

Para aprender más, consulte Compatibilidad de drivers.

En el siguiente ejemplo, se realiza la autenticación y la conexión a un clúster de Atlas utilizando una cadena de conexión URI. Se deben reemplazar los marcadores de posición en el ejemplo con las credenciales y los detalles de implementación.

Nota

Para realizar la conexión a un clúster Atlas M0 gratuito o a un clúster Flex, se debe usar una versión del driver C que sea compatible con MongoDB 7.0 y versiones posteriores. Para obtener la documentación completa sobre la compatibilidad entre el driver C y MongoDB, se debe consultar la matriz de compatibilidad de MongoDB. Recomendamos actualizar a la versión más reciente del driver.

client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");db = mongoc_client_get_database (client, "<databaseName>");
Versión de MongoDB
Versiones recomendadas de controladores

Todo

Consulte la matriz de compatibilidad de MongoDB para las últimas versiones recomendadas de controladores.

MongoDB 7.0 y versiones posteriores

Versión 1.11 o posterior

Nota

Las siguientes opciones de configuración solo se aplican si se ejecuta el driver C en modo de un solo hilo.

Los controladores de MongoDB intentan automáticamente la selección del servidor tras un evento de elección de clúster o conmutación por error. Por defecto, el controlador C genera inmediatamente un error si su primer intento de seleccionar un servidor falla. Los siguientes ajustes de configuración pueden mejorar la conectividad de una aplicación a un clúster de Atlas a costa de pasar más tiempo en un bucle de selección de servidor:

  • Configura serverSelectionTryOnce en false para dirigir al controlador C a realizar la selección del servidor hasta el límite de tiempo definido por serverSelectionTimeoutMS.

  • Reduzca el serverSelectionTimeoutMS a 15000 desde el valor por defecto de 30000. Las elecciones de MongoDB suelen tardar 10 segundos, pero pueden ser tan rápidas como 5 segundos en Atlas. Configurar este valor en 15 segundos (15000 milisegundos) cubre el límite superior de la elección más tiempo adicional para la latencia.

En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.

Seleccionar el lenguaje
Califique esta página