/ /

创建MongoDB客户端

Overview

要连接到 MongoDB 部署，您需要满足两个条件：

一个 连接 URI，也称为一个 连接字符串，它告诉 C++ 驱动程序要连接到哪个 MongoDB 部署。
一个mongocxx::客户端对象，它创建与MongoDB 部署的连接并允许您对其执行操作。

您还可以使用这些组件来自定义C++驱动程序在连接到MongoDB时的行为方式。

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

注意

mongocxx::实例

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

要学习；了解有关创建实例的更多信息，请参阅创建驱动程序实例。

连接 URI

标准连接string包括以下组件：

组件	说明
`mongodb://`	必需。将其标识为标准连接格式中字符串的前缀。
`db_username:db_password`	可选。身份验证凭证。如果包含这些内容，客户端将根据`authSource`中指定的数据库对用户进行身份验证。有关`authSource`连接选项的更多信息，请参阅身份验证机制。
`host[:port]`	必需。运行 MongoDB 的主机和可选端口号。如果不包含端口号，驱动程序将使用默认端口`27017` 。
`/defaultauthdb`	可选。如果连接string包含 `db_username:db_password@` 身份验证档案但不包含 `authSource` 选项，则要使用的身份验证数据库。如果不包含此组件，客户端将根据`admin`数据库对用户进行身份验证。
`?<options>`	可选。一个查询string ，它将特定于连接的选项指定为 `<name>=<value>` 对。有关这些选项的完整说明，请参阅指定连接选项。

有关创建连接string 的更多信息，请参阅 MongoDB Server文档中的连接字符串。

创建一个 `mongocxx::client`

要创建与MongoDB的连接，请构造 mongocxx::uri 类的实例，将连接 URI 作为string传递给构造函数。然后，将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://localhost:27017");
    mongocxx::client client(uri);
}

提示

客户端重用

由于每个mongocxx::client对象代表一个数据库连接池，因此大多数应用程序只需要一个mongocxx::client实例，甚至在多个请求中也是如此。

API 文档

要学习有关在C++驱动程序中创建 mongocxx::client对象的详情，请参阅以下API文档：

mongocxx::客户端

后退

创建驱动程序实例

来年

选择连接目标

Overview

注意

mongocxx::实例

连接 URI

创建一个 mongocxx::client

提示

客户端重用

API 文档

创建一个 `mongocxx::client`