Otimizar queries com índices

Visão geral

Nesta página, você pode ver exemplos de código copiáveis que demonstram como usar o driver C++ para trabalhar com tipos comuns de índices.

Para usar um exemplo desta página, copie o exemplo de código para oaplicativo de amostra ou para seu próprio aplicativo. Certifique-se de substituir todos os espaços reservados nos exemplos de código, como <connection string>, pelos valores relevantes para sua implantação do MongoDB.

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
}

Índice de campo único

O seguinte código mostra como criar um índice de campo único ascendente:

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" }

Para saber mais sobre índices de campo único, consulte o guia Índices de campo único.

Índice composto

O seguinte código mostra como criar um índice composto descendente:

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" }

Para saber mais sobre índices compostos, consulte o guia Índices compostos .

Remover um Índice

O seguinte código mostra como remover um índice:

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

Index dropped.

Para saber mais sobre como remover índices, consulte a seção Remover um índice do guia Trabalhar com índices.

Remover todos os índices

O seguinte código mostra como remover todos os índices em uma coleção:

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

All indexes removed.

Para saber mais sobre como remover índices, consulte a seção Remover um índice do guia Trabalhar com índices.

Gerenciamento do índice do Atlas Search

As seções a seguir contêm exemplos de código que descrevem como gerenciar índices de Atlas Search . Para saber mais sobre os índices do Atlas Search , consulte o guia Índices do 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

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

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());

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