インデックスによるクエリの最適化

項目一覧

Overview

サンプルアプリケーション
単一フィールドインデックス
複合インデックス
インデックスを削除する
すべてのインデックスを削除する
Atlas Search インデックスマネジメント
検索インデックスを作成
検索インデックスをリストする
検索インデックスを更新
検索インデックスを削除

Overview

このページでは、 C++ドライバーを使用して一般的なタイプのインデックスを操作する方法を示すコピー可能なコード例があります。

Tip

インデックスの操作の詳細については、インデックスとの連携ガイドをご覧ください。このページに表示されているインデックスの詳細については、各セクションに提供されているリンクを参照してください。

このページの例を使用するには、コード例をサンプルアプリケーションまたは独自のアプリケーションにコピーします。 <connection string>など、コード例にあるすべてのプレースホルダーを、MongoDB 配置に関連する値に置き換えてください。

サンプルアプリケーション

次のサンプルアプリケーションを使用して、このページのコード例をテストできます。サンプルアプリケーションを使用するには、次の手順を実行します。

プロジェクトが C++ ドライバーをインポートできるロケーションに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 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>");

戻る

データベースとコレクション

インデックスとの連携

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	}