Optimiza queries con índices

Overview

En esta página, puedes ver ejemplos de código copiables que demuestran cómo usar el driver C++ para trabajar con tipos comunes de índices.

Para utilizar un ejemplo de esta página, copie el ejemplo de código en el aplicación de muestra o su propia aplicación. Asegúrese de reemplazar todos los marcadores de posición en los ejemplos de código, como <connection string>, con los valores relevantes para tu implementación de 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 un solo campo

El siguiente código muestra cómo crear un índice de un solo campo 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 obtener más información sobre índices de un solo campo, consulte la Guía de índices de campo único.

Índice compuesto

El siguiente código muestra cómo crear un índice compuesto 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 aprender más sobre índices compuestos, consulta la guía de Índices compuestos.

Remover un índice

El siguiente código muestra cómo remover un índice:

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

Index dropped.

Remover todos los índices

El siguiente código muestra cómo remover todos los índices en una colección:

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

All indexes removed.

Gestión de índices de MongoDB Search

Las siguientes secciones contienen ejemplos de código que describen cómo gestionar los índice MongoDB Search. Para obtener más información sobre los índices de búsqueda de MongoDB, consulte la guía de Índices de búsqueda de MongoDB.

// 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>");