/ /

インデックスを使用したクエリの最適化

このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。Kotlin Syncドライバーのバージョンをアップグレードする方法については、現在のドキュメントを表示してください。

Overview

このページでは、 Kotlin Sync ドライバーを使用してさまざまなタイプのインデックスを管理する方法を示すコピー可能なコード例を紹介します。

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

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

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

Maven または Gradle プロジェクトに Kotlin Sync ドライバーがインストールされていることを確認します。
次のコードをコピーし、新しい.ktファイルに貼り付けます。
このページからコード例をコピーし、ファイル内の指定された行に貼り付けます。

1 import com.mongodb.ConnectionString
2 import com.mongodb.MongoClientSettings
3 import com.mongodb.kotlin.client.*
4 import com.mongodb.client.model.Filters.*
5 import org.bson.Document
6 
7 fun main() {
8     val uri = "<connection string URI>"
9     
10     val settings = MongoClientSettings.builder()
11         .applyConnectionString(ConnectionString(uri))
12         .retryWrites(true)
13         .build()
14 
15     // Create a new client and connect to the server
16     val mongoClient = MongoClient.create(settings)
17     val database = mongoClient.getDatabase("<database name>")
18     val collection = database.getCollection<Document>("<collection name>")
19 
20     // Start example code here
21 
22     // End example code here
23 }

単一フィールドインデックス

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

collection.createIndex(Indexes.ascending("<field name>"))

単一フィールドインデックスの詳細については、単一フィールドインデックスガイドをご覧ください。

複合インデックス

次の例では、指定されたフィールドに複合インデックスを作成しています。

collection.createIndex(Indexes.ascending("<field name 1>", "<field name 2>"))

Multikey Index

次の例では、指定された配列値フィールドにマルチキーインデックスを作成します。

collection.createIndex(Indexes.ascending("<array field name>"))

地理空間インデックス

次の例では、GeoJSON オブジェクトを含む指定されたフィールドに2 dsphere インデックスを作成します。

collection.createIndex(Indexes.geo2dsphere("<GeoJSON object field>"))

ユニークインデックス

次の例では、指定されたフィールドに一意のインデックスを作成しています。

val indexOptions = IndexOptions().unique(true)
collection.createIndex(Indexes.ascending("<field name>"), indexOptions)

ワイルドカードインデックス

次の例では、指定されたコレクションにワイルドカードインデックスを作成します。

collection.createIndex(Indexes.ascending("$**"))

クラスター化されたインデックス

次の例では、 _idフィールドにクラスター化インデックスを持つ新しいコレクションを作成します。

val clusteredIndexOptions = ClusteredIndexOptions(
    Indexes.ascending("_id"),
    true
)
val collection = database.createCollection("<collection name>", clusteredIndexOptions)

Atlas Search インデックスマネジメント

次のセクションには、Atlas Search インデックスを管理する方法を説明するコード例が含まれています。

検索インデックスを作成

次の例では、指定されたフィールドに Atlas Searchインデックスを作成します。

val index = Document("mappings", Document("dynamic", true))
collection.createSearchIndex("<index name>", index)

検索インデックスをリストする

次の例では、指定されたコレクション内の Atlas Search インデックスの一覧を出力します。

val results = collection.listSearchIndexes()
results.forEach { result ->
    println(result)
}

検索インデックスを更新

次の例では、指定された新しいインデックス定義で既存の Atlas Searchインデックスをアップデートします。

val newIndex = Document("mappings", Document("dynamic", true))
collection.updateSearchIndex("<index name>", newIndex)

検索インデックスを削除

次の例では、指定された名前の Atlas Searchインデックスを削除します。

collection.dropIndex("<index name>")

Text Index

次の例では、指定された string フィールドにテキストインデックスを作成します。

collection.createIndex(Indexes.text("<field name>"))

インデックスの削除

次の例では、指定された名前のインデックスを 1 つ削除します。

collection.dropIndex("<index name>")

戻る

個別のフィールド値の取得

インデックスとの連携

1	import com.mongodb.ConnectionString
2	import com.mongodb.MongoClientSettings
3	import com.mongodb.kotlin.client.*
4	import com.mongodb.client.model.Filters.*
5	import org.bson.Document
6
7	fun main() {
8	val uri = "<connection string URI>"
9
10	val settings = MongoClientSettings.builder()
11	.applyConnectionString(ConnectionString(uri))
12	.retryWrites(true)
13	.build()
14
15	// Create a new client and connect to the server
16	val mongoClient = MongoClient.create(settings)
17	val database = mongoClient.getDatabase("<database name>")
18	val collection = database.getCollection<Document>("<collection name>")
19
20	// Start example code here
21
22	// End example code here
23	}