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串連
mongodb://fred:foobar@localhost |
使用使用者fred和密碼foobar串連,指定資料庫baz
mongodb://fred:foobar@localhost/baz |
串連到兩台伺服器組成的Replica Sets
mongodb://example.com:27017,example2.com:27017 |
串連到三台本機伺服器組成的Replica Sets(分別使用27017、27018和27019連接埠)
mongodb://localhost,localhost:27018,localhost:27019 |
串連到三台伺服器組成的Replica Sets,把所有寫操作集中在主庫,讀操作分布在各叢庫
mongodb://host1,host2,host3/?slaveOk=true |
使用安全模式串連
mongodb://localhost/?safe=true |
安全模式下串連到一組Replica Sets,等待至少兩台機器同步成功,並設定兩秒的逾時時間
mongodb://host1,host2,host3/?safe=true;w=2;wtimeoutMS=2000 |
串連池(Connection Pooling)
伺服器每個TCP串連對應一個進程。強力推薦你在應用程式中實現自身的串連池。多數驅動程式也會在背後悄悄幫你做串連池。一個常見的例外是你的應用會為每個請求重新設定一個新進程譬如CGI和PHP。