MongoDB连接字符串格式参数及说明


MongoDB的标准连接字符串格式及参数分析说明

标准格式如下:

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


mongodb:// 是一个必填的前缀,它标识当前字符串是标准连接格式。

{{username:password@}}可选。给出用户名和密码后,驱动将在连接到数据库后尝试登录。

host1 uri里唯一的必填项,数据库的连接地址。

:portX 可选。默认连接到27017端口。

/database 是希望连接到的数据库名,只有在提供 username:password@ 后该值才有效。如果不指定,默认将连接"admin"数据库。

可以任意指定多个数据库和端口,这用于实现连接到replica pairs/sets。


可选项有:

connect=direct|replicaset

direct: 直接建立一个到服务器的连接。如果指定了多个host,将按先后顺序挨个尝试建立连接,直到连接建立成功为止。如果只指定了一个host,则 direct 为默认值。


replicaset: 使用creplica set semantics建立连接(即使只提供了一个host)。指定的host作为种子列表来查找完整的replica set。当指定多个host时 replicaset 为默认值。

replicaset=name

驱动验证建立连接的replica set的名字。隐含 connect=replicaset。


slaveok=true|false

true: 对于 connect=direct 模式,驱动对列表中的第一个服务器建立连接,即使它不是主服务器。对 connect=replicaset 模式,驱动将所有写操作发送到主节点,将所有读操作按round robin顺序分发到从节点。

false: 对 connect=direct 模式,驱动按顺序尝试所有host直到找到主节点。对 connect=replicaset 模式,驱动将只连接到主节点,并将所有读操作和写操作都发送到主节点。


safe=true|false

true: 驱动在每次更新操作后都发送 getlasterror 命令以确保更新成功(参考 w 和 wtimeout)。

false: 驱动每次更新操作后不发送 getlasterror 命令。

w=n

驱动给 getlasterror 发送 { w : n } 命令。隐含 safe=true。

wtimeout=ms

驱动给 getlasterror 添加 { wtimeout : ms } 参数。隐含 safe=true。

fsync=true|false

true: 驱动给 getlasterror 添加 { fsync : true } 参数。隐含 safe=true。

false: 驱动不添加 fsync 参数。

示例

连接到一个运行在本机默认端口(27017)的MongoDB


mongodb://localhost 

连接到一个运行在本机默认端口(27017)的MongoDB,并以用户名"fred"和密码"foobar"登录,登录后将默认使用admin数据库


mongodb://fred:foobar@localhost 

连接到一个运行在本机默认端口(27017)的MongoDB,并以用户名"fred"和密码"foobar"登录,登录后将使用baz数据库


mongodb://fred:foobar@localhost/baz 

连接到一个replica pair,一台服务器在example1.com,另一台在example2.com


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 

注:这种类型的连接字符串可用于在你偏好使用某台服务器但有可供替换的服务器的时候。


使用safe模式连接到本机


mongodb://localhost/?safe=true 

使用safe模式连接到replica set,等待备份在至少两台机器上完成,timeout时间为2秒


mongodb://host1,host2,host3/?safe=true;w=2;wtimeout=2000 

连接池

 

每个TCP连接将对应一个数据库线程。因此强烈建议你使用某种形式的连接池技术。幸运的是,大部分官方数据库驱动已经内置实现了这个功能。但如果你使用CGI或是PHP,对应每个新的请求可能启动一个新的应用进程,这种情况下需要特别注意连接的处理。


回到顶部