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

サンプル データ

このガイドの例では、 Atlas サンプル データセットのsample_restaurantsデータベースのrestaurantsコレクションを使用します。 MongoDB Atlas クラスターを無料で作成して、サンプル データセットをロードする方法については、 「 Atlas を使い始める 」ガイドを参照してください。

次の Kotlin データ クラスは、このコレクション内のドキュメントをモデル化します。

data class Restaurant(
    val name: String,
    val borough: String,
    val cuisine: String
)

コレクション全体で個別の値を取得

次の例では、 restaurantsコレクション内のboroughフィールドの個別の値を取得します。

val results = collection.distinct<String>(Restaurant::borough.name)
results.forEach { result ->
    println(result)
}

結果には、コレクション内のすべてのドキュメントにわたってboroughフィールドに表示されるすべての個別の値が表示されます。 boroughフィールドの値は複数のドキュメントで同じですが、各値は結果に 1 回だけ表示されます。

指定されたドキュメント全体で個別の値を取得

distinct()メソッドにクエリフィルターを提供すると、コレクション内のドキュメントのサブセット全体で個別のフィールド値を検索できます。 クエリフィルター は、 操作内のドキュメントを照合するために使用される検索条件を指定する 式 です。 クエリフィルターの作成の詳細については、「 クエリの指定 」を参照してください。

次の例では、 cuisineフィールドの値が"Italian"であるすべてのドキュメントのboroughフィールドの個別の値を取得します。

val results = collection.distinct<String>(
    Restaurant::borough.name,
    eq(Restaurant::cuisine.name, "Italian")
)
results.forEach { result ->
    println(result)
}

個別の動作の変更

distinct()メソッドは、 distinct()メソッド呼び出しにメソッドを連鎖させることで変更できます。 オプションを指定しない場合、ドライバーは操作をカスタマイズしません。

次の表では、 distinct()操作をカスタマイズするために使用できるいくつかの方法について説明します。

distinct()メソッドを変更するのに使用できるメソッドの完全なリストについては、 DistinguishedIterable を参照してください API ドキュメント。

次の例では、 boroughフィールド値が"Bronx"で、かつcuisineフィールド値が"Pizza"であるすべてのドキュメントのnameフィールドの個別の値を取得します。 また、 commentオプションを使用して操作にコメントを追加します。

val results = collection.distinct<String>(
    Restaurant::name.name,
    and(
        eq(Restaurant::borough.name, "Bronx"),
        eq(Restaurant::cuisine.name, "Pizza")
    )
).comment("Bronx pizza restaurants")
results.forEach { result ->
    println(result)
}

API ドキュメント

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。

• distinct()

• DistingIterable