MongoDB_C_Driver使用教程(2)高级连接
高级连接(Advanced Connection)
以下指南包含MongoDB配置的特定类型的信息。
简单的连接到独立服务器的示例，请参考MongoDB_C_Dirver使用教程。
要连接到启用身份验证选项的服务器，请参考身份验证页 Authentication page。
原文地址
1、连接到一个副本集(Replica Set)
连接到一个副本集与连接到独立的MongoDB服务器类似。只需要使用?replicaSet=副本集名指定URI的副本集名字选项。
#include <bson.h>
#include <mongoc.h>
int
main (int argc,
char *argv[])
{
mongoc_client_t *client;
/* 初始化libmongoc's */
mongoc_init ();
/* 创建 MongoDB Client连接到副本集 */
client = mongoc_client_new ("mongodb://host01:27017,host02:27017,host03:27017/?replicaSet=myreplset");
/* Do some work */
/* TODO */
/* 清理 */
mongoc_client_destroy (client);
mongoc_cleanup ();
return 0;
}
MongoDB连接字符串
URI中可以指定多个主机名(hostname)，使用,分割种子列表(seed list)中的指定的主机。
更多信息
[Advanced Connections](#Advanced Connections)
2、连接到分片集群(Sharded Cluster)
连接到分片集群，需要指定client要连接的mongos节点。mongodb c dirver中会自动检查已连接到的mongo分片服务器。
如果指定多个主机名，则种子列表(seed list)的创建将会在mongos实例之间尝试故障转移。
连接到分片服务器时，指定
replicaSet参数是无效的。
#include <bson.h>
#include <mongoc.h>
int
main (int argc,
char *argv[])
{
mongoc_client_t *client;
/* 初始化libmongoc's */
mongoc_init ();
/* 创建MongoDB Client连接到分片集群 */
client = mongoc_client_new ("mongodb://myshard01:27017/");
/* Do something with client ... */
/* 释放client */
mongoc_client_destroy (client);
mongoc_cleanup ();
return 0;
}
更多信息
关于集群，分布式集群等内容，可以参考
http://www.cnblogs.com/aoldman/p/4191822.html
http://www.cnblogs.com/huangfox/p/3543351.html
3、连接到IPv6地址
mongodb c dirver将自动解析IPv6地址到主机名(hostname)。在URI中指定IPv6地址时，需要使用[]进行包裹。
mongoc_uri_t *uri = mongoc_uri_new ("mongodb://[::1]:27017");
4、连接到Unix Domain Socket(Unix域套接字)
在类Unix系统中，mongodb c dirver可以直接连接到使用Unix域套接字的MongoDB服务器。只需要传入这个socket的路径，但必须使用.sock后缀。
mongoc_uri_t *uri = mongoc_uri_new ("mongodb:///tmp/mysocket.sock");
直接连接到
Unix域套接字不是常见做法。
5、通过SSL连接到服务器
以下是配置TLS/SSL连接的说明。
基本配置
运行本地服务器(端口27017)示例
$ mongod --port 27017 --sslMode requireSSL --sslPEMKeyFile server.pem --sslCAFile ca.pem
添加/?ssl=true到客户端URI尾部
mongoc_client_t *client = NULL;
client = mongoc_client_new ("mongodb://localhost:27017/?ssl=true");
指定客户端证书
默认情况下，MongoDB要求指定客户端证书，除非在提供--sslAllowConnectionsWithoutCertificates情况下。mongodb c dirver可以使用mongoc_ssl_opt_t为客户端配置证书。
/* 获取默认的ssl选项 */
const mongoc_ssl_opt_t *ssl_default = mongoc_ssl_opt_get_default ();
/* 使用的ssl选项结构体 */
mongoc_ssl_opts_t ssl_opts = { 0 };
/* 可以选择从用户自定义的目录或文件拷贝;否则使用默认值. */
memcpy (&ssl_opts, ssl_default, sizeof ssl_opts); // 使用默认值
//ssl_opts.pem_file = "client.pem"; // 使用自定义pem文件
/* 为客户端设置ssl选项 */
mongoc_client_set_ssl_opts (client, &ssl_opts);
通过pem_file提供的客户端证书必须由--sslCAFile列出的服务器信任的证书颁发机构之一颁发。或者由服务器上的本地证书存储中的 CA 颁发，在使用默认值时。
为了验证一个指定的CA服务器的证书，需要提供PEM armored文件(PEM装甲文件)和CA证书。或CA证书列表包含使用ca_file选项在，或CA的c_rehash目录结构。当没有提供ca_file或ca_dir，mongodb c dirver将使用本机平台证书存储区提供的CA。
6、其他连接选项
其他的连接选项的MongoDB URI可以看这里
