Master-Slave connection to Mongo.
Performs all writes to Master instance and distributes reads among all slaves. Reads are tried on each slave in turn until the read succeeds or all slaves failed.
Create a new Master-Slave connection.
The resultant connection should be interacted with using the same mechanisms as a regular MongoClient. The MongoClient instances used to create this MasterSlaveConnection can themselves make use of connection pooling, etc. MongoClient instances used as slaves should be created with the read_preference option set to SECONDARY. Write concerns are inherited from master and can be changed in this instance.
Raises TypeError if master is not an instance of MongoClient or slaves is not a list of at least one MongoClient instances.
Parameters: |
|
---|
DEPRECATED: Use the ‘w’ write_concern option instead.
Use getlasterror with every write operation?
New in version 2.0.
DEPRECATED: Use write_concern instead.
Returns a dict of the getlasterror options set on this instance.
Changed in version 2.4: Deprecated get_lasterror_options.
New in version 2.0.
DEPRECATED: Use write_concern instead.
Set getlasterror options for this instance.
Valid options include j=<bool>, w=<int/string>, wtimeout=<int>, and fsync=<bool>. Implies safe=True.
Parameters: |
|
---|
Changed in version 2.4: Deprecated set_lasterror_options.
New in version 2.0.
DEPRECATED: Use write_concern instead.
Unset getlasterror options for this instance.
If no options are passed unsets all getlasterror options. This does not set safe to False.
Parameters: |
|
---|
Changed in version 2.4: Deprecated unset_lasterror_options.
New in version 2.0.
Close a single database cursor.
Raises TypeError if cursor_id is not an instance of (int, long). What closing the cursor actually means depends on this connection’s cursor manager.
Parameters: |
|
---|
Get a list of all database names.
Disconnect from MongoDB.
Disconnecting will call disconnect on all master and slave connections.
See also
Module mongo_client
New in version 1.10.1.
Default class to use for documents returned on this connection.
Drop a database.
Parameters: |
|
---|
End the current “request”.
See documentation for MongoClient.end_request.
If this MasterSlaveConnection is connected to mongos (always False)
New in version 2.3.
Return the maximum size BSON object the connected master accepts in bytes. Defaults to 4MB in server < 1.7.4.
New in version 2.6.
Return the maximum message size the connected master accepts in bytes.
New in version 2.6.
The maxWireVersion reported by the server.
Returns 0 when connected to server versions prior to MongoDB 2.6.
New in version 2.7.
The maxWriteBatchSize reported by the server.
Returns a default value when connected to server versions prior to MongoDB 2.6.
New in version 2.7.
The minWireVersion reported by the server.
Returns 0 when connected to server versions prior to MongoDB 2.6.
New in version 2.7.
Set the cursor manager for this connection.
Helper to set cursor manager for each individual MongoClient instance that make up this MasterSlaveConnection.
Start a “request”.
Start a sequence of operations in which order matters. Note that all operations performed within a request will be sent using the Master connection.
Whether calling start_request() assigns greenlet-local, rather than thread-local, sockets.
New in version 2.4.2.