$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 は各パラメータをコレクション内の各ドキュメントと比較するため、パフォーマンスの問題が発生する可能性があります。パフォーマンスを向上させるには、クエリを実行する field にインデックスを作成します。インデックスを使用すると、 MongoDB は各 $in 要素の限界を作成し、より効率的に検索できます。

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

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

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

例

例で使用されている 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