An ApsaraDB for MongoDB sharded cluster instance provides the connection string for each mongos node. You can access the databases of the sharded cluster instance after connecting to a mongos node. However, you must use a correct method to connect to a sharded cluster instance to implement load balancing and high availability.
A sharded cluster instance distributes and stores data on multiple shards to facilitate high scalability. When creating a sharded cluster instance, ApsaraDB for MongoDB uses a Configserver to store the metadata of the cluster and uses one or more mongos nodes to provide the entrance to the cluster for applications. The mongos nodes read routing information from the Configserver to route requests to corresponding shards at the backend.
- When you connect to a mongos node, the mongos node can function as a mongod process.
- All mongos nodes are equal. You can connect to one or more mongos nodes to access a sharded cluster instance.
- Mongos nodes are stateless and can be scaled out as required. The service capability of a sharded cluster instance is subject to the smaller one between the total service capability of shards and that of mongos nodes.
- When you access a sharded cluster instance, we recommend that you share the load of applications evenly among multiple mongos nodes.
Connection string URIs
To correctly connect to a sharded cluster instance, you must understand the format of connection string URIs of MongoDB. All official MongoDB drivers allow you to use a connection string URI to connect to MongoDB.
mongodb://: the prefix, indicating a connection string URI.
username:password@: the username and password used to log on to the database.
hostX:portX: the list of connection string used to connect to mongos nodes.
/database: the database corresponding to the username and password if authentication is enabled.
?options: additional connection options.
Use a connection string URI to connect to a sharded cluster instance
You can use a connection string URI to connect to a sharded cluster instance to implement load balancing and high availability.
- Obtain the connection string URI of a sharded cluster instance. For more information, see Overview of sharded cluster instance connections.
- Use the obtained connection string URI to connect your applications to the instance.
For more information, see Connect to an ApsaraDB for MongoDB instance by using the program code.
Example of the Java code:
MongoClientURI connectionString = new MongoClientURI("mongodb://:****@s-xxxxxxxx.mongodb.rds.aliyuncs.com:3717,s-xxxxxxxx.mongodb.rds.aliyuncs.com:3717/admin"); //Replace **** with the password of the root user. MongoClient client = new MongoClient(connectionString); MongoDatabase database = client.getDatabase("mydb"); MongoCollection<Document> collection = database.getCollection("mycoll");Note
After you use the preceding method to connect to a sharded cluster instance, a client can automatically distribute requests to multiple mongos nodes to balance the load. If you have used a connection string URI to connect to two or more mongos nodes and a mongos node is faulty, the client can automatically skip this faulty node and distribute requests to the other normal mongos nodes.
Common connection options
- Implement read/write splitting
readPreference=secondaryPreferredin the options parameter to set read preference to secondary nodes.Example:
- Limit connections
maxPoolSize=xxin the options parameter to limit the maximum number of connections in the connection pool of a client to xx.
- Send an acknowledgment after data has been written to the majority of nodes
w= majorityin the options parameter to ensure that ApsaraDB for MongoDB sends an acknowledgment to a client after writing data to the majority of nodes for a write request.