$in

互換性

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

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

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

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

構文

$in 演算子は次の形式をとります。

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

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

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

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

• に渡すパラメータの数を数十個に制限します。 $inに渡されるパラメータの数を数十個に制限します。数百のパラメータを使用すると、クエリのパフォーマンスに悪影響を与える可能性があります。

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

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

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

この演算子の 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/ ] } } )

詳細

• find()

• updateMany()

• $or

• $set

• $elemMatch