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.
Dica
Para saber mais sobre qualquer um dos índices mostrados nesta página, consulte o link fornecido em cada seção.
Para usar um exemplo desta página, copie o exemplo de código no aplicativo de amostra ou em 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.
Aplicativo de amostra
Você pode usar o seguinte aplicativo de exemplo para testar os exemplos de código nesta página. Para usar o aplicativo de amostra, execute as seguintes etapas:
Verifique se você tem o driver C++ instalado em um local de onde seu projeto possa importá-lo.
Copie o código a seguir e cole-o em um novo arquivo
.cppdentro do seu projeto.Copie um exemplo de código desta página e cole-o na seção destacada do arquivo.
<iostream>
<bsoncxx/builder/basic/document.hpp> <bsoncxx/json.hpp> <mongocxx/client.hpp> <mongocxx/exception/exception.hpp> <mongocxx/instance.hpp> <mongocxx/uri.hpp>
using bsoncxx::builder::basic::kvp;using bsoncxx::builder::basic::make_document;
int main() { try { mongocxx::instance instance;
mongocxx::uri uri("<connection string>"); mongocxx::client client(uri);
auto database = client["<database name>"]; auto collection = database["<collection name>"];
// Start example code here
// End example code here
} catch (const mongocxx::exception& e) { std::cout << "An exception occurred: " << e.what() << "\n"; return EXIT_FAILURE; } return EXIT_SUCCESS;}Í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;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;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;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;Gerenciamento do índice de pesquisa e pesquisa vetorial do MongoDB
As seções a seguir contêm exemplos de código que descrevem como gerenciar índices de pesquisa MongoDB e Vector Search .
Para saber mais sobre os índices de pesquisa do MongoDB, consulte o guia Índices de pesquisa do MongoDB.
Para saber mais sobre os índices do MongoDB Vector Search, consulte o guia de índices do MongoDB Vector Search.
Criar uma busca ou índice de pesquisa vetorial
O código a seguir mostra como criar um índice de pesquisa do MongoDB Search que indexa dinamicamente todos os campos compatíveis na coleção especificada:
// Create a search index model with your index name and definitionauto 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 indexauto result = siv.create_one(model);std::cout << "New index name: " << result << std::endl;O seguinte código mostra como criar um índice MongoDB Vector Search em um campo especificado:
// Create a vector search index model with your index name and definitionauto model = mongocxx::search_index_model("<vectorSearchIndexName>",make_document( kvp("fields", make_array(make_document( kvp("type", "vector"), kvp("path", "<fieldName>"), kvp("numDimensions", 2048), kvp("similarity", "dotProduct"), kvp("quantization", "scalar"))))));model.type("vectorSearch");
// Create the vector search indexauto result = siv.create_one(model);std::cout << "New index name: " << result << std::endl;Listar índices de pesquisa e Vector Search
O código a seguir imprime uma lista dos índices MongoDB Search e Vector Search na coleção especificada:
auto siv = collection.search_indexes();auto result = siv.list(); for (const auto &idx : result) { std::cout << bsoncxx::to_json(idx) << std::endl;}Atualizar índices de pesquisa ou Vector Search
O seguinte código atualiza um índice de pesquisa MongoDB existente com a nova definição de índice especificada:
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());O seguinte código atualiza um índice MongoDB Vector Search existente com a nova definição de índice especificada:
auto siv = collection.search_indexes();auto definition = make_document( kvp("fields", make_array(make_document( kvp("type", "vector"), kvp("path", "<fieldName>"), kvp("numDimensions", 2048), kvp("similarity", "euclidean"), kvp("quantization", "binary")))));siv.update_one("<vectorSearchIndexName>", definition.view());Excluir índices de pesquisa ou Vector Search
O seguinte código excluir um índice de pesquisa MongoDB com o nome especificado:
auto siv = collection.search_indexes();siv.drop_one("<searchIndexName>");