Retrieve Distinct Values

項目一覧

Overview

サンプルドキュメント
distinct
ドキュメントフィールドパラメーター
例
クエリパラメータ
Options Parameter
詳細情報
API ドキュメント

Overview

コレクション全体で指定されたフィールドの個別の値をすべて取得するには、 distinct()メソッドを使用します。

サンプルドキュメント

このガイドの例えに従うには、次のコードスニペットを使用してレストランを説明するドキュメントをmyDB.restaurantsコレクションに挿入します。

const myDB = client.db("myDB");
const myColl = myDB.collection("restaurants");
await myColl.insertMany([
  { "_id": 1, "restaurant": "White Bear", "borough": "Queens", "cuisine": "Chinese" },
  { "_id": 2, "restaurant": "Via Carota", "borough": "Manhattan", "cuisine": "Italian" },
  { "_id": 3, "restaurant": "Borgatti's", "borough": "Bronx", "cuisine": "Italian" },
  { "_id": 4, "restaurant": "Tanoreen", "borough": "Brooklyn", "cuisine": "Middle Eastern" },
  { "_id": 5, "restaurant": "Äpfel", "borough": "Queens", "cuisine": "German" },
  { "_id": 6, "restaurant": "Samba Kitchen", "borough": "Manhattan", "cuisine": "Brazilian" },
]);

注意

クエリ操作により、一致するドキュメントを含むカーソルへの参照が返される場合があります。カーソルに保存されているデータを調べる方法については、「カーソルの基礎ページ」を参照してください。

distinct

distinct()メソッドでは、パラメータとしてドキュメントフィールドが必要です。メソッドの出力を調整するには、次の任意のパラメーターを指定できます。

結果を改善するためのqueryパラメータ
照合ルールを設定するためのoptionsパラメータ

ドキュメントフィールドパラメーター

ドキュメントフィールドの名前を渡して、フィールドの一意の値のリストを返します。

例

"Queens"と"Manhattan"の各値は、サンプルドキュメントに複数回表示されます。ただし、次の例では、 boroughフィールドの一意の値を検索します。

// specify "borough" as the field to return values for
const cursor = myColl.distinct("borough");
for await (const doc of cursor) {
  console.dir(doc);
}

このコードは、次のborough値を出力します。

[ "Bronx", "Brooklyn", "Manhattan", "Queens" ]

クエリパラメータ

クエリパラメータを指定すると、クエリに一致するドキュメントの一意の値を返すことができます。

クエリフィルターの作成の詳細については、「クエリの指定」を参照してください。

例

次の例では、 cuisineフィールドの個別の値を出力しますが、 "Brooklyn"のレストランは除外しています。

// exclude Brooklyn restaurants from the output
const query = { borough: { $ne: "Brooklyn" }};
// find the filtered distinct values of "cuisine"
const cursor = myColl.distinct("cuisine", query);
for await (const doc of cursor) {
  console.dir(doc);
}

この場合、クエリフィルターは、 "Brooklyn"を除くすべてのまたはの値と一致します。これにより、 distinct()は 1 つのcuisine値である"Middle Eastern"を出力するのを防ぎます。このコードでは、次の値が出力されます。

[ "Brazilian", "Chinese", "German", "Italian" ]

Options Parameter

collationフィールドをoptionsパラメータとして定義することで、 distinct()メソッドに照合を指定できます。このフィールドを使用すると、 stringの順序付けと比較のリージョンルールを設定できます。

照合を適用する手順については、「照合」を参照してください。

注意

optionsパラメータを使用する場合は、 queryパラメータも指定する必要があります。クエリフィルターを使用しない場合は、クエリを{}として定義します。

例

次の例では、個別のrestaurant値を出力するときに、 collationフィールドを使用してドイツ語の順序付け規則を指定します。

// define an empty query document
const query = {};
// specify German string ordering conventions
const options = { collation: { locale: "de" }};
const cursor = myColl.distinct("restaurant", query, options);
for await (const doc of cursor) {
  console.dir(doc);
}

この場合、ドイツの string 順序付け規則では、"O" で始まる単語が "B" で始まる単語の前に配置されます。このコードでは、以下の内容が出力されます。

[ "Äpfel", "Borgatti's", "Samba Kitchen", "Tanoreen", "Via Carota", "White Bear" ]

collationフィールドを指定しない場合、出力順序はデフォルトのバイナリ照合ルールに従います。これらのルールでは、アクセントが付いていない最初の文字を持つ単語の後に、"O" で始まる単語を配置します。

[ "Borgatti's", "Samba Kitchen", "Tanoreen", "Via Carota", "White Bear", "Äpfel" ]

詳細情報

個別の値を取得する実行可能な例については、「フィールドの個別の値を取得する」を参照してください。

API ドキュメント

distinct()メソッドとそのパラメータについて詳しくは、 APIドキュメントをご覧ください。

戻る

カーソルからのデータへのアクセス

結果を並べ替える