AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

$in(クエリ述語演算子)

$in

$in 演算子は、フィールドの値が指定された配列内の任意の値と等しいドキュメントを選択します。

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

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

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

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

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

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

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

注意

このドキュメントでは、$inクエリ演算子について説明します。$in集計演算子については、$in(式演算子) を参照してください。

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" ] }] )

このクエリでは、inventory コレクションの quantity フィールドの値が 5 または 15 であるドキュメントを選択します。

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

出力:

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

$or 演算子を使用してクエリを書き込むことができますが、同じフィールドで等価性チェックを実行する場合は、$or 演算子ではなく $in 演算子を使用します。

次の updateMany() 操作では、tags 配列に "home" または "school" のいずれかに一致する要素が少なくとも1つある場合、exclude フィールドが false に設定されます。

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 }

配列のクエリに関するその他の例えは、以下を参照してください。

クエリに関するその他の例については、ドキュメントの読み取りを参照してください。

$in 演算子では、/pattern/ 形式の正規表現を使用してドキュメントを選択できます。$regex 表現は $in 内で使用できません。

このクエリでは、tags フィールドが be または st で始まる inventory コレクションのドキュメントを選択します。

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

このクエリでは、tags フィールドに be または st で始まる文字列があるか、be または st で始まる要素が少なくとも1つある配列を持つinventory コレクションのすべてのドキュメントを選択します。