话说客户端连接mongoDB的连接参数（转载）

sunyke

　　MongoDB是数据库服务器: 它运行在前端或者后端等待用户的连接. 当你启动MongoDB，会看到如下结果:





~/$ ./mongod

## some logging output

#

Tue Mar  9 11:15:43 waiting for connections on port 27017

Tue Mar  9 11:15:43 web admin interface listening on port 28017

　　这时候，已经不输出日志了，但是并不意味着日志输出停止，MongoDB等待客户端连接到27017端口。只要连接上了，日志就继续输出。你可以使用MongoDB驱动和Mongo Shell来连接数据库。


MongoDB连接并不支持HTTP协议，所有你不能直接通过浏览器访问MongoDB。


标准连接的字符串格式
　　

有些驱动还不支持之中uri模式。可以参考具体驱动，看看如何定义uri标准连接的。如果驱动不支持，它们都会有可选的方法来指定连接。

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

• mongodb://这是固定的格式，必须要指定。
  
• username:password@这是可选的. 如果设置，在连接数据库服务器之后，驱动都会尝试登陆这个数据库。
  
• host1是这个URI唯一要填写的。它指定了要连接服务器的地址。
  
• :portX可选的指定端口，如果不填，默认为27017 。
  
• /database是要连接数据库的名称 ，这个参数和username:password@有关联。.如果没有指定，默认的数据库为admin。
  
• ?options 是连接参数. 要注意的是，如果database不填写，也要保留符号"/"和"?"。参数格式是name=value。如果填写多个分隔符为"&"或者";"。
  

　　如果要连接复制集，请指定多个主机地址。
　　参数如下：

• 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
  
  
  
  • The connection pool is not allowed to grow beyond this size. When a thread requests a connection it either: receives one immediately from the connection pool if one is available, receives a newly created connection if the pool has not reached the maximum size, or waits for a connection to be released by another thread (see waitQueueTimeoutMS and waitQueueMultiple).
    
  
  
  
• minPoolSize=n
  
  
  
  • 一些驱动会把没用的连接关闭。 然而,如果连接数低于minPoolSize值之下， 它们不会关闭空闲的连接。注意的是连接会按照需要进行创建，因此当连接池被许多连接预填充的时候，minPoolSize不会生效。
    
  
  
  
• waitQueueTimeoutMS=ms
  
  
  
  • 在超时之前，线程等待连接生效的总时间。如果连接池到达最大并且所有的连接都在使用，这个参数就生效了。
    
  
  
  
• waitQueueMultiple=n
  
  
  
  • 驱动强行限制线程同时等待连接的个数。 这个限制了连接池的倍数。
    
  
  
  
• connectTimeoutMS=ms
  
  
  
  • 可以打开连接的时间。
    
  
  
  
• socketTimeoutMS=ms
  
  
  
  • 发送和接受sockets的时间。
    
  
  
  

　　字符串连接不区分大小写。

例子
　　连接本地数据库服务器，端口是默认的。





mongodb://localhost
　　使用用户名fred，密码foobar登录localhost的admin数据库。





mongodb://fred:foobar@localhost
　　


使用用户名fred，密码foobar登录localhost的baz数据库。




mongodb://fred:foobar@localhost/baz
　　连接 replica pair, 服务器1为example1.com服务器2为example2。





mongodb://example1.com:27017,example2.com:27017
　　连接  replica set 三台服务器 (端口 27017, 27018, 和27019):





mongodb://localhost,localhost:27018,localhost:27019
　　连接 replica set 三台服务器, 写入操作应用在主服务器 并且分布查询到从服务器。





mongodb://host1,host2,host3/?slaveOk=true
　　直接连接第一个服务器，无论是replica set一部分或者主服务器或者从服务器。





mongodb://host1,host2,host3/?connect=direct;slaveOk=true
　　当你的连接服务器有优先级，还需要列出所有服务器，你可以使用上述连接方式。
　　安全模式连接到localhost:





mongodb://localhost/?safe=true
　　以安全模式连接到replica set，并且等待至少两个复制服务器成功写入，超时时间设置为2秒。





mongodb://host1,host2,host3/?safe=true;w=2;wtimeoutMS=2000
连接池
　　
每个TCP连接服务器都会使用一个线程。因此强烈建议你的应用使用连接池。幸运的是，大部分驱动都实现了。要注意的特例就是每个请求都要创建新的进程的设置，如CGI何PHP的一些设置。