$ne
定義
$ne
$ne
指定したフィールドの値が指定した値と等しくないドキュメントを選択します。これには、指定したフィールドが含まれていないドキュメントが含まれます。異なる BSON type の値を比較するには、 が指定する BSON 比較順序 を参照してください。
互換性
次の環境でホストされる配置には $ne
を使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
$ne
演算子は次のような形をとります。
{ field: { $ne: value } }
注意
$ne
演算子の値が null の場合、詳細については「非等価フィルター」を参照してください。
例
次の例では、inventory
コレクションを使用しています。コレクションを作成するには、mongosh
でinsertMany()
コマンドを実行します。
db.inventory.insertMany( [ { "item": "nuts", "quantity": 30, "carrier": { "name": "Shipit", "fee": 3 } }, { "item": "bolts", "quantity": 50, "carrier": { "name": "Shipit", "fee": 4 } }, { "item": "washers", "quantity": 10, "carrier": { "name": "Shipit", "fee": 1 } } ] )
等しくないドキュメント フィールドのマッチング
quantity
が 20
と等しくない inventory
コレクション内のすべてのドキュメントを選択します。このクエリは、quantity
フィールドがないドキュメントも選択します。
db.inventory.find( { quantity: { $ne: 20 } } )
{ _id: ObjectId("61ba667dfe687fce2f042420"), item: 'nuts', quantity: 30, carrier: { name: 'Shipit', fee: 3 } }, { _id: ObjectId("61ba667dfe687fce2f042421"), item: 'bolts', quantity: 50, carrier: { name: 'Shipit', fee: 4 } }, { _id: ObjectId("61ba667dfe687fce2f042422"), item: 'washers', quantity: 10, carrier: { name: 'Shipit', fee: 1 } }
このクエリに相当する SQL は次のとおりです。
SELECT * FROM INVENTORY WHERE QUANTITIY != 20
等しくない埋め込みドキュメントフィールドに基づく更新
次の例では、埋め込みドキュメント内のフィールドと $ne
を比較して price
フィールドを設定します。updateMany()
操作では、サブフィールド名が fee
と設定されている埋め込みドキュメント carrier
を検索します。fee
の値が 1
と等しくない場合、または fee
サブフィールドが存在しない場合に、各ドキュメントで $set
を使用して price
フィールドを 9.99
に更新します。
db.inventory.updateMany( { "carrier.fee" : { $ne: 1 } }, { $set: { "price": 9.99 } } )
{ _id: ObjectId("61ba66e2fe687fce2f042423"), item: 'nuts', quantity: 30, carrier: { name: 'Shipit', fee: 3 }, price: 9.99 }, { _id: ObjectId("61ba66e2fe687fce2f042424"), item: 'bolts', quantity: 50, carrier: { name: 'Shipit', fee: 4 }, price: 9.99 }, { _id: ObjectId("61ba66e2fe687fce2f042425"), item: 'washers', quantity: 10, carrier: { name: 'Shipit', fee: 1 } }
このクエリに相当する SQL は次のとおりです。
UPDATE INVENTORY SET PRICE = '9.99' WHERE carrierfee != 1
不等価演算子 $ne
はインデックスの大部分と一致することが多いため、あまり選択的ではありません。その結果、多くの場合、インデックス付きの $ne
クエリは、コレクション内のすべてのドキュメントをスキャンする必要がある $ne
クエリよりもパフォーマンスが良くありません。「クエリの選択性」も参照してください。