Utilización de la información de conexión

Toda la información que necesita un controlador para establecer una conexión con tu despliegue se encuentra en la sección "MongoDB" de una credencial creada en la página Credenciales de servicio. La tabla contiene un desglose para referencia.

• 0... indica que puede haber una o varias de estas entradas en una matriz.

Muchos controladores ' MongoDB ' son capaces de conectarse a su despliegue cuando se les da la cadena de conexión con formato URI que se encuentra en el campo "composed" de la información de conexión. Cloud Databases proporciona una instancia de alta disponibilidad de ' MongoDB,, así que asegúrate de incluir todos los miembros en la cadena de conexión. Por ejemplo:

mongodb://admin:$PASSWORD@d5eeee66-5bc4-498a-b73b-1307848f1eac.8f7bfd8f3faa4218aec56e069eb46187-0.databases.appdomain.cloud:30484,d5eeee66-5bc4-498a-b73b-1307848f1eac.8f7bfd8f3faa4218aec56e069eb46187-1.databases.appdomain.cloud:30484,d5eeee66-5bc4-498a-b73b-1307848f1eac.8f7bfd8f3faa4218aec56e069eb46187-2.databases.appdomain.cloud:30484/<database name>?authSource=admin&replicaSet=replset

El parámetro de consulta replicaSet contiene el nombre de conjunto de réplicas del despliegue. Probablemente es replset. Algunos controladores y aplicaciones necesitan que se les pase por separado.

El ejemplo siguiente utiliza la información de la serie de conexión y el Controlador Java de MongoDB para conectarse a la base de datos.

public class MongodbConnect {
    private static Logger log = LoggerFactory.getLogger(LoggerFactory.class);

    public static void main(String[] args) {

        System.setProperty("javax.net.ssl.trustStore", "path/to/keystore");
        System.setProperty("javax.net.ssl.trustStorePassword", "store_password");

        // make sure you append ssl=true to the connection URI
        final String mongoURI = "mongodb://user:password@host:port,host:port/?authSource=admin&replicaSet=replset&ssl=true";

        MongoClient mongoClient = MongoClients.create(mongoURI);
        boolean testDB = false;

        // this loop will continue attempting to connect to the database until the admin database is found
        while (!testDB) {
            try {
                // check if you can connect to the database by checking for
                // the presence of the admin database. If the admin databases isn't found
                // then you're not connected.
                MongoIterable<String> databases = mongoClient.listDatabaseNames();
                for (String name: databases) {
                    if (name.contains("admin")) {
                        System.out.println("admin found...");
                        testDB = true;
                    }
                }
            } catch (Exception e) {
                log.info(e.getMessage());
            }
        }

        // close connection
        mongoClient.close();

    }
}

El ejemplo siguiente utiliza información de la serie de conexión y del controlador Python pymongo para conectarse a la base de datos. Esto es sólo un ejemplo sencillo de conexión, sin gestión errores ni la lógica de reintento, y puede que no sea adecuado en entornos de producción.

import pymongo
from pymongo import MongoClient
from pymongo.errors import ConnectionFailure


client = MongoClient(
    "mongodb://admin:$PASSWORD@host.databases.appdomain.cloud:30484/<database name>?authSource=adminreplicaSet=replset",
    ssl=True,
    ssl_ca_certs="/path/to/cert/ca-certificate.crt"
)

try:
    db_list = client.list_database_names()
    print("List of databases:")
    print(db_list)

except ConnectionFailure as err:
    print("Unable to connect to database")

Este ejemplo final utiliza el controlador MongoDB Node.js

const MongoClient = require("mongodb").MongoClient;

let connectionString = "mongodb://<username>:<password>@<host>:<port>,<host>:<port>/<database>?authSource=admin&replicaSet=replset";

let options = {
    tls: true,
    tlsCAFile: `/path/to/cert`,
    useUnifiedTopology: true
};

// connects to a MongoDB database
MongoClient.connect(connectionString, options, function (err, db) {
    if (err) {
        console.log(err);
    } else {
       // lists the databases that exist in the deployment
        db.db('example').admin().listDatabases(function(err, dbs) {
            console.log(dbs.databases);
            db.close();
        });
    }
});

Soporte de TLS para controladores y certificados propietarios de servicios

Todas las conexiones a Databases for MongoDB tienen habilitado TLS 1.2, por lo que el controlador que se utiliza para conectar tiene que admitir el cifrado.

Los siguientes suites de cifrado están soportados por Databases for MongoDB Enterprise Edition:

• ECDHE-ECDSA-AES128-GCM-SHA256
• ECDHE-RSA-AES128-GCM-SHA256
• ECDHE-ECDSA-AES256-GCM-SHA384
• ECDHE-RSA-AES256-GCM-SHA384
• ECDHE-ECDSA-CHACHA20-POLY1305
• ECDHE-RSA-CHACHA20-POLY1305
• DHE-RSA-AES128-GCM-SHA256
• DHE-RSA-AES256-GCM-SHA384

Su implantación también incluye un certificado propietario del servicio para que el controlador pueda verificar el servidor en el momento de la conexión.

Para obtener más información, consulte Cloud Databases FAQ de certificados.

Otros controladores de lenguaje

MongoDB tiene una amplia gama de controladores de lenguaje. En la tabla se incluyen algunos de los más comunes. Si busca más idiomas, pruebe la lista de controladores de MongoDB.org.