文档菜单
文档首页
/
语言
/
C++
/
C++ 驱动程序
/
连接到 MongoDB

创建 MongoDB 客户端

在本页

  • 概述
  • 连接 URI
  • 创建一个mongocxx::client
  • API 文档

概述

要连接到MongoDB部署，你需要以下两项

  • 连接URI，也称为连接字符串，告诉C++驱动程序要连接到哪个MongoDB部署。

  • mongocxx::client对象，它创建到MongoDB部署的连接并允许您对其进行操作。

您也可以使用这两个组件之一来自定义C++驱动程序在连接到MongoDB时的行为。

本指南将向您展示如何创建连接字符串并使用mongocxx::client对象连接到MongoDB。

注意

mongocxx::instance

本页面上的代码示例假设您已在应用程序的其他位置创建了mongocxx::instance对象。

要了解更多关于创建实例的信息，请参阅创建驱动程序实例.

连接URI

标准连接字符串包含以下组件

组件
描述

mongodb://

必需。一个前缀，用于标识该字符串为标准连接格式。

db_username:db_password

可选。身份验证凭据。如果您包括这些凭据，则客户端将用户对authSource中指定的数据库进行身份验证。有关authSource连接选项的更多信息，请参阅身份验证机制。

host[:port]

必需。MongoDB运行的主机名和可选的端口号。如果您不包含端口号，则驱动程序使用默认端口号27017。

/defaultauthdb

可选。如果连接字符串包含db_username:db_password@身份验证凭据但没有authSource选项，则使用的身份验证数据库。如果您不包含此组件，则客户端将对admin数据库进行用户身份验证。

?

可选。一个查询字符串，指定连接特定选项，格式为 <名称>=<值> 对。有关这些选项的完整说明，请参阅指定连接选项。

有关创建连接字符串的更多信息，请参阅连接字符串（在MongoDB服务器文档中）。

创建一个 mongocxx::client

要创建到MongoDB的连接，构造一个 mongocxx::uri 类的实例，将连接URI作为字符串传递给构造函数。然后，将 mongocxx::uri 类的实例传递给 mongocxx::client 构造函数。

在下面的示例中，驱动程序使用一个示例连接URI来连接到本地主机（localhost）上的端口 27017 的MongoDB部署。

#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
#include <mongocxx/client.hpp>
int main()
{
    mongocxx::instance instance;
    mongocxx::uri uri("mongodb://#:27017");
    mongocxx::client client(uri);
}

提示

重用您的客户端

因为每个 mongocxx::client 对象都表示到数据库的连接池，大多数应用程序只需要一个 mongocxx::client 实例，即使在多个请求之间也是如此。

API文档

要了解有关在C++驱动程序中创建 mongocxx::client 对象的更多信息，请参阅以下API文档

返回

创建驱动程序实例

下一页

选择连接目标