インデックスの作成

前提条件

このガイドのコード例を実行するには、プログラムに次のインポート ステートメントを含める必要があります。

import com.mongodb.reactivestreams.client.MongoClient;
import com.mongodb.reactivestreams.client.MongoClients;
import com.mongodb.reactivestreams.client.MongoDatabase;
import com.mongodb.reactivestreams.client.MongoCollection;
import org.bson.Document;
import com.mongodb.client.model.Indexes;
import com.mongodb.client.model.IndexOptions;
import com.mongodb.client.model.Filters;

MongoDB 配置への接続

まず、MongoDB 配置に接続し、 インスタンスとMongoDatabase MongoCollectionインスタンスを 宣言して定義します。

次のコードは、ポート27017のlocalhostで実行されているスタンドアロンの MongoDB 配置に接続します。 次に、 testデータベースを参照するためのdatabase変数と、 restaurantsコレクションを参照するためのcollection変数を定義します。

MongoClient mongoClient = MongoClients.create();
MongoDatabase database = mongoClient.getDatabase("test");
MongoCollection<Document> collection = database.getCollection("restaurants");

MongoDB 配置への接続の詳細については、「 MongoDB への接続」チュートリアルを参照してください。

昇順インデックス

昇順インデックスの仕様を作成するには、 Indexes.ascending()静的ヘルパー メソッドを使用します。

collection.createIndex(Indexes.ascending("name"))
    .subscribe(new PrintToStringSubscriber<String>());

collection.createIndex(Indexes.ascending("stars", "name"))
    .subscribe(new PrintToStringSubscriber<String>());

降順インデックス

降順インデックスの仕様を作成するには、 Indexes.descending()静的ヘルパー メソッドを使用します。

collection.createIndex(Indexes.descending("stars"))
    .subscribe(new PrintToStringSubscriber<String>());

collection.createIndex(Indexes.descending("stars", "name"))
    .subscribe(new PrintToStringSubscriber<String>());

複合インデックス

複合インデックスの仕様を作成するには、 Indexes.compoundIndex()静的ヘルパー メソッドを使用します。

次の例では、 starsフィールドでは降順で、 nameフィールドでは昇順で複合インデックスが作成されます。

collection.createIndex(
    Indexes.compoundIndex(Indexes.descending("stars"),
        Indexes.ascending("name"))
).subscribe(new PrintToStringSubscriber<String>());

Text Indexes

MongoDB は、string コンテンツのテキスト検索をサポートするための テキストインデックス を提供します。 テキストインデックスには、値が string または複数の string 配列である任意のフィールドを含めることができます。 テキスト インデックスの仕様を作成するには、 Indexes.text()静的ヘルパー メソッドを使用します。

次の例では、 nameフィールドに テキスト インデックスを作成しています。

collection.createIndex(Indexes.text("name"))
    .subscribe(new PrintToStringSubscriber<String>());

ハッシュされたインデックス

ハッシュ インデックス インデックスの仕様を作成するには、 Indexes.hashed()静的ヘルパー メソッドを使用します。

次の例では、 _idフィールドに ハッシュされたインデックスを作成しています。

collection.createIndex(Indexes.hashed("_id"))
    .subscribe(new PrintToStringSubscriber<String>());

地理空間インデックス

地理空間クエリをサポートするために、MongoDB はさまざまな地理空間インデックスをサポートしています。

collection.createIndex(Indexes.geo2dsphere("contact.location"))
    .subscribe(new PrintToStringSubscriber<String>());

インデックス オプション

インデックス仕様ドキュメントに加えて、 createIndex()メソッドは インデックス オプション ドキュメントを受け入れることができます。これは、一意のインデックスまたは部分インデックスを作成するようにドライバーに指示します。

ドライバーはさまざまなインデックス オプションを指定するためのIndexOptionsクラスを提供します。

次のインポート ステートメントをコードに追加して、 IndexOptionsインスタンスを作成します。

import com.mongodb.client.model.IndexOptions;

IndexOptions indexOptions = new IndexOptions().unique(true);
collection.createIndex(Indexes.ascending("name", "stars"), indexOptions)
    .subscribe(new PrintToStringSubscriber<String>());

IndexOptions partialFilterIndexOptions = new IndexOptions()
    .partialFilterExpression(Filters.exists("contact.email"));
collection.createIndex(
    Indexes.descending("name", "stars"), partialFilterIndexOptions)
    .subscribe(new PrintToStringSubscriber<String>());

コレクションのインデックスのリストの取得

インデックスのリストを取得するには、 listIndexes()メソッドを使用します。 次のコードを使用することで、 コレクションのインデックスが一覧表示されます。

collection.listIndexes().subscribe(new PrintDocumentSubscriber());

その他のインデックス オプションの詳細については、サーバー マニュアルの「インデックス プロパティ」を参照してください。