distinct

項目一覧

定義
互換性
構文
コマンドフィールド
動作
例

定義

distinct: 単一のコレクション全体で指定されたフィールドの個別の値を検索します。 distinctは、個別の値の配列を含むドキュメントを返します。返されるドキュメントには、クエリ統計とクエリプランが付属する埋め込みドキュメントも含まれます。
Tip
mongoshでは、このコマンドは db.collection.distinct()ヘルパーメソッドを通じて実行することもできます。
ヘルパーメソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンドを使用します。

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージドサービスです

重要

このコマンドは、M0 、M2 、M5 、および Flex クラスターでのサポートが限定されています。詳細については、「サポートされていないコマンド」を参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

このコマンドの構文は、次のとおりです。

db.runCommand(
   {
     distinct: "<collection>",
     key: "<field>",
     query: <query>,
     readConcern: <read concern document>,
     collation: <collation document>,
     comment: <any>,
     hint: <string or document>
   }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

フィールド

タイプ

説明

distinct

string

個別の値をクエリするコレクションの名前。

key

string

個別の値を返すフィールド。

query

ドキュメント

任意。個別の値を取得するドキュメントを指定するクエリ。

readConcern

ドキュメント

任意。読み取り保証 (read concern) を指定します。

readConcern オプションの構文は、次のとおりです。readConcern: { level: <value> }

次の読み取り保証レベルが利用できます。

"local"。これは、プライマリとセカンダリに対する読み取り操作での、デフォルトの読み取り保証レベルです。
"available" 。プライマリおよびセカンダリに対する読み取り操作に使用できます。"available" は、プライマリおよびシャーディングされていないセカンダリに対して "local" と同じように動作します。クエリは、インスタンスの最新データを返します。
"majority" 。WiredTiger ストレージエンジンを使用するレプリカセットで使用できます。
"linearizable" 。primary の読み取り操作にのみ使用できます。

読み取り保証 (read concern) のレベルについて詳しくは、「読み取り保証 (read concern) レベル」を参照してください。

collation

ドキュメント

任意。

操作に使用する照合を指定します。

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

照合オプションの構文は次のとおりです。

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

照合を指定する場合、locale フィールドは必須ですが、その他の照合フィールドはすべて任意です。フィールドの説明については、照合ドキュメントを参照してください。

照合が指定されていなくても、コレクションにデフォルトの照合が設定されている場合（db.createCollection() を参照）には、コレクションの照合が使用されます。

コレクションにも操作にも照合が指定されていない場合、MongoDB では以前のバージョンで使用されていた単純なバイナリ比較によって文字列が比較されます。

1 つの操作に複数の照合は指定できません。たとえば、フィールドごとに異なる照合を指定できません。また、ソートと検索を一度に実行する場合、検索とソートで別の照合を使用できません。

comment

any

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

attr.command.cursor.comment フィールド内のmongod ログメッセージ。
command.comment フィールドのデータベースプロファイラー出力。
command.comment フィールドのcurrentOp出力。

コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

hint

文字列またはドキュメント

任意。インデックス名を string またはドキュメントとして指定します。指定すると、クエリプランナーはヒント指定したインデックスを使用するプランのみを考慮します。詳細については、「インデックスの指定」を参照してください。

バージョン 7.1 で追加。

注意

結果は BSON サイズの最大を超えることはできません。結果が BSON サイズの最大を超える場合は、「集計パイプラインを使用した個別の値の取得」で説明されているように、$group 演算子を使用して集計パイプラインで個別の値を取得します。

MongoDB は、コマンド用の shell ラッパーメソッドdb.collection.distinct() distinctも提供します。さらに、多くの MongoDBドライバーはラッパーメソッドを提供します。具体的なドライバーのドキュメントを参照してください。

動作

シャーディングされたクラスターでは、distinct コマンドが孤立したドキュメントを返す場合があります。

時系列コレクションの場合、distinct コマンドはインデックスを効率的に使用できません。代わりに、$group 集計を使用して、ドキュメントを個別の値でグループ化します。詳細は「時系列の制限」をご覧ください。

配列フィールド

指定された field の値が配列の場合、 distinct では配列の各要素が別個の値として扱われます。

たとえば、フィールドの値が [ 1, [1], 1 ] の場合、distinct は 1、[1]、1 を別々の値として扱います。

MongoDB 6.0 以降では、配列を使用する場合、 distinct コマンドではコレクションとビューに対して同じ結果が返されます。

例については、以下を参照してください。

配列フィールドの個別の値を返す
コレクションとビュー内の配列

インデックスの使用

可能な場合、 distinct 操作ではインデックスを使用できます。

インデックスは distinct操作もカバーできます。インデックスによってカバーされるクエリの詳細については、「カバーされたクエリ」を参照してください。

トランザクション

トランザクション内で個別の操作を実行するには、以下を使用できます。

シャーディングされていないコレクションの場合、db.collection.distinct() メソッドや distinct コマンドと、$groupステージの集計パイプラインを使用できます。
シャーディングされたコレクションの場合、db.collection.distinct() メソッド、または distinct コマンドは使用できません。
シャーディングされたコレクションの個別の値を検索するには、代わりに $group ステージで集計パイプラインを使用します。詳細については、「個別の操作」を参照してください。

重要

ほとんどの場合、分散トランザクションでは 1 つのドキュメントの書き込み (write) よりもパフォーマンスコストが高くなります。分散トランザクションの可用性は、効果的なスキーマ設計の代わりにはなりません。多くのシナリオにおいて、非正規化されたデータモデル（埋め込みドキュメントと配列）が引き続きデータやユースケースに最適です。つまり、多くのシナリオにおいて、データを適切にモデリングすることで、分散トランザクションの必要性を最小限に抑えることができます。

トランザクションの使用に関するその他の考慮事項（ランタイム制限や oplog サイズ制限など）については、「本番環境での考慮事項」も参照してください。

クライアントの切断

MongoDB 4.2以降では、 distinctを発行したクライアントが操作の完了前に切断した場合、MongoDB は killOp を使用してdistinctを終了対象としてマークし。

レプリカセットノードの状態の制限

レプリカセットノード上で distinct 操作を実行するには、ノードが PRIMARY または SECONDARY状態である必要があります。ノードが STARTUP2 などの別の状態にある場合、操作はエラーになります。

インデックスフィルターと照合

MongoDB 6.0 以降、インデックスフィルターは、以前はplanCacheSetFilter コマンドを使用して設定されていた照合を使用します。

MongoDB 8.0以降では、インデックスフィルターを追加する代わりに、クエリ設定を使用します。インデックスフィルターは MongoDB 8.0以降非推奨です。

クエリ設定は、インデックスフィルターよりも多くの機能を持ちます。また、インデックスフィルターは永続的ではなく、すべてのクラスターノードに対してインデックスフィルターを簡単に作成することはできません。クエリ設定を追加して例を探すには、 setQuerySettingsを参照してください。

クエリ設定

バージョン8.0の新機能。

クエリ設定を使用して、インデックスヒント、操作拒否フィルター、その他のフィールドを設定できます。設定はクラスター全体のクエリシェイプに適用されます。クラスターは、シャットダウン後も設定を保持します。

クエリオプティマイザは、クエリプランニング中の追加入力としてクエリ設定を使用します。これは、クエリを実行するために選択されたプランに影響します。クエリ設定を使用してクエリシェイプをブロックすることもできます。

クエリ設定を追加して例を調べるには、setQuerySettings を参照してください。

find、distinct、および aggregate コマンドのクエリ設定を追加できます。

クエリ設定にはより多くの機能があり、廃止されたインデックスフィルターよりも優先されます。

クエリ設定を削除するには、 removeQuerySettingsを使用します。クエリ設定を取得するには、集計パイプラインの$querySettingsステージを使用します。

例

この例では、次のドキュメントを含む inventory コレクションを使用します。

{ "_id": 1, "dept": "A", "item": { "sku": "111", "color": "red" }, "sizes": [ "S", "M" ] }
{ "_id": 2, "dept": "A", "item": { "sku": "111", "color": "blue" }, "sizes": [ "M", "L" ] }
{ "_id": 3, "dept": "B", "item": { "sku": "222", "color": "blue" }, "sizes": "S" }
{ "_id": 4, "dept": "A", "item": { "sku": "333", "color": "black" }, "sizes": [ "S" ] }

フィールドの個別の値を返す

次の例では、inventory コレクション内のすべてのドキュメントからフィールド dept の個別の値を返します。

db.runCommand ( { distinct: "inventory", key: "dept" } )

このコマンドは、個別の dept 値を含む values という名前のフィールドがあるドキュメントを返します。

{
   "values" : [ "A", "B" ],
   "ok" : 1
}

埋め込みフィールドの個別の値を返す

次の例では、inventory コレクション内のすべてのドキュメントから、item フィールドに埋め込まれたフィールド sku の個別の値を返します。

db.runCommand ( { distinct: "inventory", key: "item.sku" } )

このコマンドは、個別の sku 値を含む values という名前のフィールドがあるドキュメントを返します。

{
  "values" : [ "111", "222", "333" ],
  "ok" : 1
}

Tip

以下も参照してください。

埋め込みドキュメント内のフィールドへのアクセスに関する情報は、ドット表記を参照してください。

配列フィールドの個別の値を返す

次の例では、inventory コレクション内のすべてのドキュメントからフィールド sizes の個別の値を返します。

db.runCommand ( { distinct: "inventory", key: "sizes" } )

このコマンドは、個別の sizes 値を含む values という名前のフィールドがあるドキュメントを返します。

{
  "values" : [ "M", "S", "L" ],
  "ok" : 1
}

distinctおよび配列フィールドの詳細については、「動作」セクションを参照してください。

コレクションとビュー内の配列

MongoDB 6.0 以降では、配列を使用する場合、 distinct コマンドではコレクションとビューに対して同じ結果が返されます。

次の例では、各ドキュメントの温度値の配列を含む sensor という名前のコレクションを作成します。

db.sensor.insertMany( [
   { _id: 0, temperatures: [ { value: 1 }, { value: 4 } ] },
   { _id: 1, temperatures: [ { value: 2 }, { value: 8 } ] },
   { _id: 2, temperatures: [ { value: 3 }, { value: 12 } ] },
   { _id: 3, temperatures: [ { value: 1 }, { value: 4 } ] }
] )

次の例では sensor コレクションから sensorView という名前のビューを作成します。

db.createView( "sensorView", "sensor", [] )

次の例では distinct を使用して sensor コレクション内の temperatures 配列から一意の値を取得します。

db.sensor.distinct( "temperatures.1.value" )

temperatures.1.value 内の 1 は、temperatures の配列インデックスを指定します。

出力例:

[ 4, 8, 12 ]

sensorView の例:

db.sensorView.distinct( "temperatures.1.value" )

出力例:

[ 4, 8, 12 ] MongoDB 6.0 以降（sensor コレクションから返される結果と同一）。
[] MongoDB 6.0 以前のバージョン

クエリの指定 `distinct`

次の例では、item フィールドに埋め込まれたフィールド sku の個別の値を、dept が "A" に等しいドキュメントから返します。

db.runCommand ( { distinct: "inventory", key: "item.sku", query: { dept: "A"} } )

このコマンドは、個別の sku 値を含む values という名前のフィールドがあるドキュメントを返します。

{
  "values" : [ "111", "333" ],
  "ok" : 1
}

照合の指定

照合を指定すると、大文字・小文字やアクセント記号など、文字列を比較するための言語独自のルールを指定できます。

コレクション myCollは、次のドキュメントを含みます。

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

下記の集計操作には照合オプションが含まれます。

db.runCommand(
   {
      distinct: "myColl",
      key: "category",
      collation: { locale: "fr", strength: 1 }
   }
)

照合フィールドの説明については、照合ドキュメントを参照してください。

デフォルトの読み取り保証を上書き

デフォルトの読み取り保証 (read concern) レベル "local" を無効にするには、readConcern オプションを使用します。

レプリカセットに対する次の操作では、大多数のノードに書き込まれたことが確認されたデータの最新のコピーを読み取るために、"majority" の読み取り保証を指定します。

注意

読み取り保証のレベルを問わず、ノード上の最新データにシステム内のデータの最新バージョンが反映されていない場合があります。

db.runCommand(
   {
     distinct: "restaurants",
     key: "rating",
     query: { cuisine: "italian" },
     readConcern: { level: "majority" }
   }
)

単一のスレッドでそれ自体の書き込みの読み取りを可能にするには、レプリカセットのプライマリに対して "majority" 読み取り保証と "majority" 書込み保証を使用します。

インデックスの指定

ヒントオプションを使用して、インデックス名またはパターンを指定できます。

インデックス名に基づいてヒントを指定するには、次の手順に従います。

db.runCommand ( { distinct: "inventory", key: "dept", hint: "sizes" } )

インデックスパターンに基づいてヒントを指定するには、次の手順に従います。

db.runCommand ( { distinct: "inventory", key: "dept", hint: { sizes: 1 } } )

戻る

count

mapReduce

distinct

定義

Tip

互換性

重要

構文

コマンドフィールド

注意

動作

配列フィールド

インデックスの使用

トランザクション

重要

クライアントの切断

レプリカセット ノードの状態の制限

インデックスフィルターと照合

クエリ設定

例

フィールドの個別の値を返す

埋め込みフィールドの個別の値を返す

Tip

以下も参照してください。

配列フィールドの個別の値を返す

コレクションとビュー内の配列

クエリの指定 distinct

照合の指定

デフォルトの読み取り保証を上書き

注意

インデックスの指定

レプリカセットノードの状態の制限

クエリの指定 `distinct`