C++驱动程序入门

Overview

MongoDB C++驱动程序是一个C++包，可用于连接到MongoDB并与部署中存储的数据交互。本指南向您展示如何创建一个应用程序，该程序使用C++驱动程序连接到MongoDB Atlas上托管的MongoDB 集群并查询集群中的数据。

提示

MongoDB Atlas 是完全托管的云数据库服务，旨在托管您的 MongoDB 部署。您可以按照本指南中的步骤创建您的免费（无需信用卡）MongoDB Atlas 部署。

按照本指南将示例 C++ 应用程序连接到 MongoDB Atlas 部署。如果您希望使用不同的驱动程序或编程语言连接MongoDB ，请参阅我们的官方驱动程序列表。

下载并安装

安装所有依赖项。

在开始本教程之前，请确保您已在开发环境中安装以下依赖项：

支持C++17 的编译器，例如 GCC 、 Clang 或 Visual Studio
CMake v3.15或更高版本
pkg-config

注意

C++17 之前的配置

尽管C++11 是支持的最低语言版本，但本教程将C++驱动程序配置为使用C++17 Polyfill 配置部分建议的C++17 标准库。如果要安装 C++17 之前版本配置的驱动程序，请将 CMAKE_CXX_STANDARD 配置选项设立为您的C++版本。然后，驱动程序将自动使用 bsoncxx 库 polyfill 实现来实现所需的 C++17 功能。

下载C++驱动程序。

要从 mongo-cxx-driver Github存储库下载最新版本的C++驱动程序，请在工作目录的Shell中运行以下命令：

curl -OL https://github.com/mongodb/mongo-cxx-driver/releases/download/r4.6.2/mongo-cxx-driver-r4.6.2.tar.gztar -xzf mongo-cxx-driver-r4.6.2.tar.gzcd mongo-cxx-driver-r4.6.2/build

配置用于安装的驱动程序。

选择与操作系统相对应的标签页，然后从mongo-cxx-driver-r4.6.2/build目录运行以下命令：

cmake ..                                \    -DCMAKE_BUILD_TYPE=Release          \    -DCMAKE_CXX_STANDARD=17

此命令指示 CMake 将mongocxx安装到/usr/local目录中。

'C:\<path>\cmake.exe' .. \    -G "Visual Studio <version> <year>" -A "x64"         \    -DCMAKE_CXX_STANDARD=17                     \    -DCMAKE_INSTALL_PREFIX=C:\mongo-cxx-driver  \

此命令指示 CMake 将mongocxx安装到C:\mongo-cxx-driver目录中。替换以下占位符值：

<path>：CMake 可执行文件的路径
<version>：您的 Visual Studio 版本号
<year>：与 Visual Studio 版本对应的年份

构建并安装驱动程序。

选择与您的操作系统相对应的标签页并运行以下命令以安装驱动程序：

cmake --build .sudo cmake --build . --target install

cmake --build . --config Releasecmake --build . --config Debugcmake --install . --config Releasecmake --install . --config Debug

注意

Windows构建配置

为了避免由于构建配置冲突而导致Windows链接器错误，前面的命令同时构建并安装 Release 和 Debug 配置。要学习；了解有关这些配置的更多信息，请参阅API和 ABI 版本控制指南中的共享库（仅限 MSVC）。

完成这些步骤后，您就已在计算机上安装了C++驱动程序。

创建 MongoDB 部署

您可以在 MongoDB Atlas 上创建一个免费集群来存储和管理您的数据。MongoDB Atlas 在云端托管和管理您的 MongoDB 数据库。

在Atlas上创建免费MongoDB 部署。

完成MongoDB入门指南，设立新的Atlas帐户并将示例数据加载到新的免费套餐MongoDB部署。

保存您的凭证。

创建数据库用户后，请将该用户的用户名和密码保存在一个安全位置，以便在后续步骤中使用。

完成这些步骤后，您就可以在 Atlas 上有一个新的免费集群，并建立数据库用户凭证，以及将示例数据加载到数据库中。

创建连接字符串

您可以通过提供连接 URI（也称为连接字符串）来连接到 MongoDB 部署，它指示驱动程序如何连接到 MongoDB 部署以及连接时的行为方式。

连接字符串包含部署的主机名或 IP 地址和端口、身份验证机制、用户档案（如果适用）以及连接选项。

要连接到未托管在Atlas上的实例或部署，请参阅选择连接目标指南。

查找MongoDB Atlas连接字符串。

要检索您在上一步中创建的部署的连接字符串，日志您的Atlas帐户并导航到 Database 部分下的 Clusters 页面。单击新部署的 Connect 按钮。

如果您尚未配置数据库用户， MongoDB将提示您创建并配置新用户。

单击 Connect to your application 部分下的 Drivers 按钮，从 Driver 选择菜单中选择“C++”，然后从 Version 选择菜单中选择与您安装的版本最匹配的版本。

确保取消选择 View full code sample 选项以仅查看连接字符串。

复制连接字符串。

单击连接string右侧的按钮将其复制到剪贴板，如以下屏幕截图所示：

更新密码占位符。

将此连接字符串粘贴到首选文本编辑器中的文件中，并将 <db_password> 占位符替换为数据库用户的密码。连接字符串已填充数据库用户的用户名。

将此文件保存到安全位置，以便在下一步中使用。

完成这些步骤后，您就拥有了与string Atlas集群对应的连接。

运行示例查询

创建项目目录。

在根目录中，在shell中运行以下命令，为此项目创建一个名为 cpp-quickstart 的目录：

mkdir cpp-quickstart

运行以下命令，在cpp-quickstart目录中创建quickstart.cpp应用程序文件：

cd cpp-quickstarttouch quickstart.cpp

创建C++驱动程序应用程序。

将以下代码复制并粘贴到quickstart.cpp文件中，该文件将查询sample_mflix数据库中的movies集合：

#include <cstdint>#include <iostream>#include <vector>
#include <bsoncxx/builder/basic/document.hpp>#include <bsoncxx/json.hpp>#include <mongocxx/client.hpp>#include <mongocxx/instance.hpp>#include <mongocxx/uri.hpp>
using bsoncxx::builder::basic::kvp;using bsoncxx::builder::basic::make_document;
int main() {    mongocxx::instance instance;    mongocxx::uri uri("<connection string URI>");    mongocxx::client client(uri);    auto db = client["sample_mflix"];    auto collection = db["movies"];
    auto result = collection.find_one(make_document(kvp("title", "The Shawshank Redemption")));    if (result) {        std::cout << bsoncxx::to_json(*result) << std::endl;    } else {        std::cout << "No result found" << std::endl;    }}

指定连接字符串。

将 <connection string> 占位符替换为从本指南的“创建连接字符串”步骤中复制的连接字符串。

运行您的C++应用程序。

在shell中，运行以下命令以编译并运行此应用程序：

c++ --std=c++17 quickstart.cpp $(pkg-config --cflags --libs libmongocxx) -o ./app.out./app.out

提示

MacOS 用户在运行上述命令后可能会看到以下错误：

dyld[54430]: Library not loaded: @rpath/libmongocxx._noabi.dylib

要解决此错误，请使用-Wl,-rpath链接器选项来设立@rpath ，如以下代码所示：

c++ --std=c++17 quickstart.cpp -Wl,-rpath,/usr/local/lib/ $(pkg-config --cflags --libs libmongocxx) -o ./app.out./app.out

命令行输出包含有关检索到的电影文档的详细信息：

{ "_id" : { "$oid" : "573a1399f29313caabceeb20" },"plot" : "Two imprisoned men bond over a number of years, finding solaceand eventual redemption through acts of common decency.",..."title" : "The Shawshank Redemption",...

如果遇到错误或应用程序打印 "No result found"，请确保在 quickstart.cpp文件中指定了正确的连接字符串并加载了示例数据。

完成这些步骤后，您有一个正常运行的应用程序，它使用驱动程序连接到 MongoDB 部署、对示例数据运行查询并打印结果。

后续步骤

恭喜您完成快速入门教程！

注意

如果您在学习本教程时运行问题，请在MongoDB Stack Overflow页面或MongoDB Reddit 社区寻求帮助，或者使用本页面右侧或右下角的 Rate this page标签页提交反馈。

在本教程中，您创建了一个C++应用程序，该应用程序连接到MongoDB Atlas上托管的MongoDB 部署，并检索与查询匹配的文档。

通过以下资源学习有关C++驱动程序的更多信息：

通过查找文档指南了解如何执行读取操作。
通过“插入文档”指南了解如何执行插入操作。
请参阅更新文档指南，了解如何执行更新操作。