話說用戶端串連mongoDB的串連參數

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的一些設定。