$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 にインデックスを作成します。

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

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

この演算子のMongoDB 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