MongoDB 标準連接配接字元串

MongoDB 标準連接配接字元串

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

注：并非所有MongoDB驅動都支援完整的連接配接字元串，不支援此格式連接配接字串的驅動會有替代連接配接方案，具體請參照驅動自身的說明文檔。

 mongodb:// 是連接配接字串必須的字首字串

 username:password@ 可選項，連接配接到資料庫後會嘗試驗證登陸

 host1 必須的指定至少一個host

 :portX 可選項，預設連接配接到27017

 /database 如果指定username:password@，連接配接并驗證登陸指定資料庫。若不指定，預設打開admin資料庫。

 ?options 是連接配接選項。如果不使用/database，則前面需要加上/。所有連接配接選項都是鍵值對name=value，鍵值對之間通過&或;（分号）隔開

連接配接選項包括：

Replica set:

replicaSet=name

驅動會校驗replica set的名字。意味着給定的hosts是主庫（seed list），驅動将試圖找到replica set中的所有成員。（•The driver verifies that the name of the replica set it connects to matches this name. Implies that the hosts given are a seed list, and the driver will attempt to find all members of the set.）

Single server:

slaveOk=true|false

自由選項：

safe=true|false

 true: 驅動程式會在送出每次更新操作後執行getLastError指令以确認更新是有效的（參見w和wtimeoutMS）

 false:驅動程式在每次更新操作後不會執行getLastError

w=n

 驅動在getLastError指令加上{ w : n } 參數。意味着safe=true

wtimeoutMS=ms

 驅動在getLastError指令加上{ wtimeout : ms }參數。意味着safe=true.

fsync=true|false

 true: 驅動在getLastError指令加上{ fsync : true } 參數。意味着safe=true.

 false: 驅動不在getlasterror 指令加fsync參數。

journal=true|false

 true: 同步到 journal. 意味着safe=true.

connectTimeoutMS=ms

 設定建立連接配接逾時，機關ms

socketTimeoutMS=ms

 設定socket發送或接受逾時時間，機關ms

這些選項都是大小寫不敏感的。

連接配接MongoDB（預設連接配接到localhost:27017）

使用使用者fred和密碼foobar連接配接

使用使用者fred和密碼foobar連接配接，指定資料庫baz

連接配接到兩台伺服器組成的Replica Sets

連接配接到三台本地伺服器組成的Replica Sets(分别使用27017、27018和27019端口)

連接配接到三台伺服器組成的Replica Sets，把所有寫操作集中在主庫，讀操作分布在各叢庫

使用安全模式連接配接

安全模式下連接配接到一組Replica Sets，等待至少兩台機器同步成功，并設定兩秒的逾時時間

連接配接池（Connection Pooling）

伺服器每個TCP連接配接對應一個程序。強力推薦你在應用程式中實作自身的連接配接池。多數驅動程式也會在背後悄悄幫你做連接配接池。一個常見的例外是你的應用會為每個請求重新配置一個新程序譬如CGI和PHP。