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

サンプル データ

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

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

次の例では、 restaurantsコレクション内の boroughフィールドの個別の値を取得します。対応するコードを表示するには、Synchronous タブまたは Asynchronousタブを選択します。

results = restaurants.distinct("borough")
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

results = await restaurants.distinct("borough")
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

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

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

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

boroughcuisine次の例では、"Italian" フィールドの個別の値を取得します。対応するコードを表示するには、Synchronous タブまたは Asynchronousタブを選択します。

results = restaurants.distinct("borough", {
    "cuisine": "Italian"
})
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Queens
Staten Island

results = await restaurants.distinct("borough", {
    "cuisine": "Italian"
})
for restaurant in results:
    print(restaurant)

Bronx
Brooklyn
Manhattan
Queens
Staten Island

個別の動作の変更

distinct()メソッドは、操作を構成するために使用できるオプションを表す任意のパラメーターを受け入れます。 オプションを指定しない場合、ドライバーは操作をカスタマイズしません。

次の表では、 distinct()をカスタマイズするために設定できるオプションについて説明しています。

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

results = restaurants.distinct("name", 
    { "borough": "Bronx", 
      "cuisine": "Pizza" }, 
    comment="Bronx pizza restaurants"
)

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
...

results = await restaurants.distinct("name", 
    { "borough": "Bronx", 
      "cuisine": "Pizza" }, 
    comment="Bronx pizza restaurants"
)

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
...