$in

互換性

次の環境でホストされる配置には $in を使用できます。

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

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

$in式を指定するには、次のプロトタイプを使用します。

{ field: { $in: [<value1>, <value2>, ... <valueN> ] } }

異なる BSON 型値の比較については、BSON 比較順序の指定を参照してください。

fieldが配列を保持している場合、 $in演算子は、指定された配列内の値と一致する要素が少なくとも 1 つ含まれる配列をfieldが保持しているドキュメントを選択します（例: <value1> 、 <value2> 、など）。

$in演算子は各パラメータをコレクション内の各ドキュメントと比較するため、パフォーマンスの問題が発生する可能性があります。パフォーマンスを向上させるには：

• お勧めするのは、

  $in 演算子に渡すパラメーターの数を数十の値に制限することです。数百個以上のパラメーターを使用すると、クエリのパフォーマンスに悪影響を与える可能性があります。

• クエリを実行したい field にインデックスを作成します。

Atlas Search を使用した Atlas 上のデータのクエリ

MongoDB Atlas に保存されているデータには、$search クエリを実行中に Atlas Search の in 演算子を使用できます。$search の後に $in を実行するのは、$search を in 演算子とともに実行する場合よりパフォーマンスが低くなります。

この演算子の Atlas Search バージョンの詳細については、Atlas ドキュメントの in 演算子を参照してください。

例

inventory コレクションを次のように作成します。

db.inventory.insertMany( [
   { "item": "Pens", "quantity": 350, "tags": [ "school", "office" ] },
   { "item": "Erasers", "quantity": 15, "tags": [ "school", "home" ] },
   { "item": "Maps", "tags": [ "office", "storage" ] },
   { "item": "Books", "quantity": 5, "tags": [ "school", "storage", "home" ] }
] )

db.inventory.find( { quantity: { $in: [ 5, 15 ] } }, { _id: 0 } )

{ item: 'Erasers', quantity: 15, tags: [ 'school', 'home' ] },
{ item: 'Books', quantity: 5, tags: [ 'school', 'storage', 'home' ] }

db.inventory.updateMany(
   { tags: { $in: [ "home", "school" ] } },
   { $set: { exclude: false } }
)

{
   item: 'Pens',
   quantity: 350,
   tags: [ 'school', 'office' ],
   exclude: false
 },
 {
   item: 'Erasers',
   quantity: 15,
   tags: [ 'school', 'home' ],
   exclude: false
 },
 {
   item: 'Books',
   quantity: 5,
   tags: [ 'school', 'storage', 'home' ],
   exclude: false
 }

db.inventory.find( { tags: { $in: [ /^be/, /^st/ ] } } )