连接字符串的URI格式

Replica Set Option¶

uri.replicaSet¶

Specifies the name of the replica set, if the mongod is a member of a replica set.

When connecting to a replica set it is important to give a seed list of at least two mongod instances. If you only provide the connection point of a single mongod instance, and omit the replicaSet, the client will create a standalone connection.

Connection Options¶

uri.ssl¶

true: Initiate the connection with SSL.

false: Initiate the connection without SSL.

The default value is false.

注解

The ssl option is not supported by all drivers. See your driver documentation and the 使用SSL连接MongoDB document.

uri.connectTimeoutMS¶

The time in milliseconds to attempt a connection before timing out. The default is never to timeout, though different drivers might vary. See the driver documentation.

uri.socketTimeoutMS¶

The time in milliseconds to attempt a send or receive on a socket before the attempt times out. The default is never to timeout, though different drivers might vary. See the driver documentation.

Connection Pool Options¶

Most drivers implement some kind of connection pooling handle this for you behind the scenes. Some drivers do not support connection pools. See your driver documentation for more information on the connection pooling implementation. These options allow applications to configure the connection pool when connecting to the MongoDB deployment.

uri.maxPoolSize¶

The maximum number of connections in the connection pool. The default value is 100.

uri.minPoolSize¶

The minimum number of connections in the connection pool. The default value is 0.

注解

The minPoolSize option is not supported by all drivers. For information on your driver, see the drivers documentation.

uri.maxIdleTimeMS¶

The maximum number of milliseconds that a connection can remain idle in the pool before being removed and closed.

This option is not supported by all drivers.

uri.waitQueueMultiple¶

A number that the driver multiples the maxPoolSize value to, to provide the maximum number of threads allowed to wait for a connection to become available from the pool. For default values, see the 驱动程序和客户端 documentation.

uri.waitQueueTimeoutMS¶

The maximum time in milliseconds that a thread can wait for a connection to become available. For default values, see the 驱动程序和客户端 documentation.

Write Concern Options¶

Write concern describes the kind of assurances that the program:mongod and the driver provide to the application regarding the success and durability of the write operation. For a full explanation of write concern and write operations in general see the: 写:

uri.w¶

Defines the level and kind of write concern, that the driver uses when calling getLastError. This option can take either a number or a string as a value.

Options:

-1 – The driver will not acknowledge write operations and will suppress all network or socket errors. 0 – The driver will not acknowledge write operations, but will pass or handle any network and socket errors that it receives to the client. If you disable write concern but enable the getLastError command’s journal option, journal overrides this w option. 1 – Provides basic acknowledgment of write operations. By specifying 1, you require that a standalone mongod instance, or the primary for replica sets, acknowledge all write operations. For drivers released after the default write concern change, this is the default write concern setting. majority (string) – For replica sets, if you specify the special majority value to w option, write operations will only return successfully after a majority of the configured replica set members have acknowledged the write operation. n (number) – For replica sets, if you specify a number greater than 1, operations with this write concern will only return after this many members of the set have acknowledged the write. If you set w to a number that is greater than the number of available set members, or members that hold data, MongoDB will wait, potentially indefinitely, for these members to become available. tags (string) – For replica sets, you can specify a tag set to require that all members of the set that have these tags configured return confirmation of the write operation. See Replica Set Tag Set Configuration for more information.

uri.wtimeoutMS¶

The time in milliseconds to wait for replication to succeed, as specified in the w option, before timing out.

uri.journal¶

Controls whether write operations will wait till the mongod acknowledges the write operations and commits the data to the on disk journal.

Options:

true (boolean) – Enables journal commit acknowledgment write concern. Equivalent to specifying the getLastError command with the j option enabled. false (boolean) – Does not require that mongod commit write operations to the journal before acknowledging the write operation. This is the default option for the journal parameter. If you set journal to true, and specify a w value less than 1, journal prevails. If you set journal to true, and the mongod does not have journaling enabled, as with nojournal, then getLastError will provide basic receipt acknowledgment (i.e. w:1), and will include a jnote field in its return document.

Read Preference Options¶

Read preferences describe the behavior of read operations with regards to replica sets. These parameters allow you to specify read preferences on a per-connection basis in the connection string:

uri.readPreference¶

Specifies the replica set read preference for this connection. This setting overrides any slaveOk value. The read preference values are the following:

• primary
• primaryPreferred
• secondary
• secondaryPreferred
• nearest

For descriptions of each value, see Read Preference Modes.

The default value is primary, which sends all read operations to the replica set’s primary.

uri.readPreferenceTags¶

Specifies a tag set as a comma-separated list of colon-separated key-value pairs. For example:

dc:ny,rack:1

To specify a list of tag sets, use multiple readPreferenceTags. The following specifies two tag sets and an empty tag set:

readPreferenceTags=dc:ny,rack:1&readPreferenceTags=dc:ny&readPreferenceTags=

Order matters when using multiple readPreferenceTags.

Miscellaneous Configuration¶

uri.uuidRepresentation¶

参数:	standard – The standard binary representation. csharpLegacy – The default representation for the C# driver. javaLegacy – The default representation for the Java driver. pythonLegacy – The default representation for the Python driver.

For the default, see the drivers documentation for your driver.

注解

Not all drivers support the uuidRepresentation option. For information on your driver, see the drivers documentation.