MongoDB的连接字符串介绍

MongoDB连接字符串常用格式

 

 

mongodb://[username:password@]host1[:port1][,host2[:port2],…[,hostN[:portN]]][/[database][?options]]

 

备注：字符串连接不区分大小写，并非所有MongoDB驱动都支持完整的连接字符串，不支持此格式连接字串的驱动会有替代连接方案，具体请参照驱动自身的说明文档，看看如何定义uri标准连接的。

 

 

1、参数说明

 

mongodb:// 这是固定的格式，必须要指定。

 

 username:password@ 可选项，如果设置，在连接数据库服务器之后，驱动都会尝试登陆这个数据库

 

host1 必须的指定至少一个host

 

host1是这个URI唯一要填写的。它指定了要连接服务器的地址。如果要连接复制集，请指定多个主机地址。

 :portX 可选的指定端口，如果不填，默认为27017

 

 /database 如果指定username:password@，连接并验证登陆指定数据库。若不指定，默认打开admin数据库。

 ?options 是连接选项。如果不使用/database，则前面需要加上/。所有连接选项都是键值对name=value，键值对之间通过&或;（分号）隔开

 

 

 

2、options 是连接参数

 

 

• connect=direct|replicaSet
  • direct: 连接方式为单个服务器。如果提供了多个主机地址，建立连接之后，按顺序访问。如果仅仅指定了一个主机，direct是默认值。
  • replicaSet: 就和描述的那样，连接到replica set . 这个主机地址列表，是为了发现replica set。 如果连接多个主机replicaSet是默认值。

 

• replicaSet=name
  • 验证replica set的名称。 Impliesconnect=replicaSet.

 

• slaveOk=true|false
  • true:在connect=direct模式下，驱动会连接第一台机器，即使这台服务器不是主。在connect=replicaSet模式下，驱动会发送所有的写请求到主并且把读取操作分布在其他从服务器。
  • false: 在connect=direct模式下，驱动会自动找寻主服务器. 在connect=replicaSet模式下，驱动仅仅连接主服务器，并且所有的读写命令都连接到主服务器。

 

• safe=true|false
  • true: 在执行更新操作之后，驱动都会发送getLastError命令来确保更新成功。(还要参考wtimeoutMS).
  • false: 在每次更新之后，驱动不会发送getLastError来确保更新成功。

 

• w=n
  • 驱动添加 { w : n } 到getLastError命令. 应用于safe=true。

 

• wtimeoutMS=ms
  • 驱动添加 { wtimeout : ms } 到 getlasterror 命令. 应用于safe=true.

 

• fsync=true|false
  • true: 驱动添加 { fsync : true } 到 getlasterror 命令.应用于safe=true.
  • false: 驱动不会添加到getLastError命令中。.

 

• maxPoolSize=n
• minPoolSize=n
  • 一些驱动会把没用的连接关闭。 然而,如果连接数低于minPoolSize值之下， 它们不会关闭空闲的连接。注意的是连接会按照需要进行创建，因此当连接池被许多连接预填充的时候，minPoolSize不会生效。

 

• waitQueueTimeoutMS=ms
  • 在超时之前，线程等待连接生效的总时间。如果连接池到达最大并且所有的连接都在使用，这个参数就生效了。

 

• waitQueueMultiple=n
  • 驱动强行限制线程同时等待连接的个数。 这个限制了连接池的倍数。

 

• connectTimeoutMS=ms
  • 可以打开连接的时间。

 

• socketTimeoutMS=ms
  • 发送和接受sockets的时间

 

 

 

参考资料：MongoDB的连接字符串    http://www.studyofnet.com/news/337.html