使用索引优化查询

本页内容

概述

示例应用
单字段索引
组合索引
删除索引
删除所有索引
Atlas 搜索索引管理
创建搜索索引
列出搜索索引
更新搜索索引
删除搜索索引

概述

在本页中，您可以查看可复制的代码示例，展示如何使用C++驱动程序处理常见类型的索引。

提示

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

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

示例应用程序

您可以使用以下示例应用程序来测试本页上的代码示例。要使用示例应用程序，请按照以下步骤操作

确保您已将C++驱动程序安装到您的项目可以导入的位置。
复制以下代码并将其粘贴到您的项目中的一个新.cpp文件中。
从本页复制一个代码示例并将其粘贴到文件的突出显示部分中。

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 
10 using bsoncxx::builder::basic::kvp;
11 using bsoncxx::builder::basic::make_document;
12 
13 int 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 索引指南。

创建搜索索引

以下代码演示了如何创建一个 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 搜索索引的列表

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

更新搜索索引

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

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 搜索索引

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

数据库和集合

与索引一起工作

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
10	using bsoncxx::builder::basic::kvp;
11	using bsoncxx::builder::basic::make_document;
12
13	int 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	}