インデックス ビルダ

Overview

このガイドでは、MongoDB Java ドライバーで ビルダ を使用して インデックス を指定する方法を学びます。「 Indexesビルダには、次のタイプのインデックスを構築するためのヘルパー メソッドが用意されています。

• 昇順インデックス

• 降順インデックス

• 複合インデックス

• Text Indexes

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

• 地理空間インデックス

インデックスは、コレクションのデータセットのサブセットを保存します。 インデックスには、特定のフィールドまたはフィールド セットの値が、フィールド値の順に保存されます。 インデックスによってカバーされるクエリの例については、「インデックスに関するガイド 」をご覧ください。

Indexesクラスは、すべてのMongoDBインデックスタイプの静的ファクトリー メソッドを提供します。各メソッドはBSONインスタンスを返します。これをcreateIndex()に渡すことができます。

import static com.mongodb.client.model.Indexes.*;

昇順インデックス

昇順インデックスを使用すると、インデックス フィールドの値でクエリ結果を最小から最大の順にソートできます。

昇順のインデックスを作成するには、まず昇順（）ビルダー Bsonメソッドを呼び出して、インデックスを作成するフィールドの名前を渡して、インデックスドキュメントを表す インスタンスを作成します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例では、 nameフィールドに昇順のインデックスを指定しています。

Bson ascendingIndex = ascending("name");
collection.createIndex(ascendingIndex);

降順インデックス

降順インデックスを使用すると、インデックス フィールドの値でクエリ結果を最大から最小の順にソートできます。

降順インデックスを作成するには、まず降順() ビルダーBson メソッドを呼び出して、インデックスを作成するフィールドの名前を渡して、インデックスドキュメントを表す インスタンスを作成します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例では、 capacityフィールドに降順のインデックスを指定しています。

Bson descendingIndex = descending("capacity");
collection.createIndex(descendingIndex);

複合インデックス

複合インデックスを作成するには、まず compoundIndex() ビルダーBson メソッドを呼び出して、インデックスを作成するフィールドの名前を渡して、インデックスドキュメントを表す インスタンスを作成します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例では、 capacityとyearフィールドに降順インデックス、その後にnameフィールドの昇順インデックスで構成される複合インデックスを指定しています。

Bson compoundIndexExample = compoundIndex(descending("capacity", "year"), ascending("name"));
collection.createIndex(compoundIndexExample);

Text Indexes

テキスト インデックスでは、インデックス付きフィールドのテキストでドキュメントがグループ化されます。

テキストインデックスを作成するには、まず text() ビルダ メソッドを呼び出して、インデックスするフィールドの名前を渡して、インデックスドキュメントを表す Bsonインスタンスを作成します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例では、「 Atlas 」フィールドにテキスト インデックス キーを指定しています。

Bson textIndex = text("theaters");
collection.createIndex(textIndex);

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

ハッシュされたインデックスは、インデックス フィールドのハッシュ値でドキュメントをグループ化します。

ハッシュされたインデックスを作成するには、まずハッシュされた() ビルダ Bsonメソッドを呼び出して、インデックスドキュメントを表す インスタンスを作成し、インデックスするフィールドの名前を渡します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例えでは、 capacityフィールドに ハッシュされたインデックスを指定します。

Bson hashedIndex = hashed("capacity");
collection.createIndex(hashedIndex);

地理空間インデックス

2dsphereインデックスは、インデックス フィールドの座標でドキュメントをグループ化します。

2dsphereインデックスを作成するには、まず geo2dsphere() ビルダー メソッドを呼び出して、インデックスドキュメントを表す Bsonインスタンスを作成し、インデックスするフィールドの名前を渡します。次に、インデックスドキュメントを含む Bsonインスタンスを渡して、コレクションの createIndex() メソッドを呼び出します。

次の例えでは、 locationフィールドに2dsphereインデックスを指定します。

Bson geo2dsphereIndex = geo2dsphere("location");
collection.createIndex(geo2dsphereIndex);