Docs 菜单
Docs 主页
/ / /
C++ 驱动程序

使用索引优化查询

在此页面上

  • Overview
  • 示例应用程序
  • 单字段索引
  • 复合索引
  • 删除索引
  • 删除所有索引
  • Atlas Search 索引管理
  • 创建Atlas Search索引
  • 搜索索引列表
  • 更新搜索索引
  • 删除Atlas Search索引

在此页面上,您可以查看可复制的代码示例,这些示例演示了如何使用C++驾驶员来处理常见的索引类型。

提示

要学习;了解有关使用索引的更多信息,请参阅使用索引指南。 要学习;了解有关此页面上显示的任何索引的更多信息,请参阅每个部分中提供的链接。

要使用本页中的示例,请将代码示例复制到示例应用程序或您自己的应用程序中。 请务必将代码示例中的所有占位符(例如 <connection string> )替换为 MongoDB 部署的相关值。

您可以使用以下示例应用程序来测试本页上的代码示例。 要使用示例应用程序,请执行以下步骤:

  1. 确保您已将C++驾驶员安装在项目可以导入的位置。

  2. 复制以下代码,并将其粘贴到项目中的新.cpp文件中。

  3. 从本页复制代码示例,并将其粘贴到文件的突出显示部分。

1#include <iostream>
2
3#include <bsoncxx/builder/basic/document.hpp>
4#include <bsoncxx/json.hpp>
5#include <mongocxx/client.hpp>
6#include <mongocxx/exception/exception.hpp>
7#include <mongocxx/instance.hpp>
8#include <mongocxx/uri.hpp>
9
10using bsoncxx::builder::basic::kvp;
11using bsoncxx::builder::basic::make_document;
12
13int main() {
14 try {
15 mongocxx::instance instance;
16
17 mongocxx::uri uri("<connection string>");
18 mongocxx::client client(uri);
19
20 auto database = client["<database name>"];
21 auto collection = database["<collection name>"];
22
23 // Start example code here
24
25 // End example code here
26
27 } catch (const mongocxx::exception& e) {
28 std::cout << "An exception occurred: " << e.what() << "\n";
29 return EXIT_FAILURE;
30 }
31
32 return EXIT_SUCCESS;
33}

以下代码展示了如何创建升序单字段索引:

auto index_specification = make_document(kvp("<fieldName>", 1));
auto result = collection.create_index(index_specification.view());
std::cout << "Index created: " << bsoncxx::to_json(result) << std::endl;
Index created: { "name" : "fieldName_1" }

要学习;了解有关单字段索引的更多信息,请参阅 单字段索引指南。

以下代码演示了如何创建降序复合索引:

auto index_specification = make_document(kvp("<fieldName1>", -1), kvp("<fieldName2>", -1));
auto result = collection.create_index(index_specification.view());
std::cout << "Index created: " << bsoncxx::to_json(result) << std::endl;
Index created: { "name" : "fieldName1_-1_fieldName2_-1" }

要了解有关复合索引的更多信息,请参阅复合索引指南。

以下代码演示了如何删除索引:

collection.indexes().drop_one("<indexName>");
std::cout << "Index dropped." << std::endl;
Index dropped.

要学习;了解有关删除索引的更多信息,请参阅 使用索引指南中的删除索引部分。

以下代码演示如何删除集合中的所有索引:

collection.indexes().drop_all();
std::cout << "All indexes removed." << std::endl;
All indexes removed.

要学习;了解有关删除索引的更多信息,请参阅 使用索引指南中的删除索引部分。

以下部分包含描述如何管理Atlas Search索引的代码示例。要学习;了解有关Atlas Search索引的更多信息,请参阅Atlas Search索引指南。

以下代码演示如何创建Atlas Search索引,该索引可为指定集合中的所有支持字段动态编制索引:

// Create an index model with your index name and definition
auto siv = collection.search_indexes();
auto name = "<searchIndexName>";
auto definition = make_document(kvp("mappings", make_document(kvp("dynamic", true))));
auto model = mongocxx::search_index_model(name, definition.view());
// Create the search index
auto result = siv.create_one(model);
std::cout << "New index name: " << result << std::endl;
New index name: searchIndexName

以下代码会打印指定集合中的Atlas Search索引列表:

auto siv = collection.search_indexes();
auto result = siv.list();
for (const auto &idx : result) {
std::cout << bsoncxx::to_json(idx) << std::endl;
}

以下代码使用指定的新索引定义更新现有Atlas Search索引:

auto siv = collection.search_indexes();
auto update_fields = make_document(kvp("<fieldName>", make_document(kvp("type", "<fieldType>"))));
auto update_definition = make_document(kvp("mappings", make_document(kvp("dynamic", false), kvp("fields", update_fields))));
siv.update_one("<searchIndexName>", update_definition.view());

以下代码删除具有指定名称的Atlas Search索引:

auto siv = collection.search_indexes();
siv.drop_one("<searchIndexName>");

后退

数据库和collection