distinct（データベースコマンド）

配列フィールド

指定された 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 ステージで集計パイプラインを使用します。詳細については、「個別の操作」を参照してください。

クライアントの切断

操作が完了する前にdistinctを発行したクライアントが切断された場合、MongoDB はdistinctをkillOpを使用して終了対象としてマークします。

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

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

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

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

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

次の例では、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
}

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

次の例では、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" 書込み保証を使用します。