Null または欠落しているフィールドのクエリ

項目一覧

等価フィルター

非等価フィルター
型チェック
有無のチェック
MongoDB Atlas を使用した Null または欠落フィールドのクエリ

次の方法を使用して、MongoDB で null または欠落しているフィールドをクエリできます。

プログラミング言語のドライバー。
MongoDB Atlas UI。詳細については、「MongoDB Atlas を使用した Null または欠落フィールドのクエリ」を参照してください。
MongoDB Compass

➤ 右上の [言語選択] ドロップダウンメニューを使用して、以下の例の言語を設定するか、MongoDB Compass を選択します。

MongoDB の各種クエリ演算子は、null 値を異なる方法で処理します。

このページでは、 db.collection.find()メソッドを使用してnull値に対してmongoshで実行されるクエリ操作の例を取りあげます。

このページの例では、inventory コレクションを使用しています。MongoDB インスタンスのテストデータベースに接続し、inventory コレクションを作成します。

このページでは MongoDB Compass を使用して、null 値をクエリする操作の例を紹介しています。

このページではnull mongoc_collection_find_with_opts を使用して、値に対して実行されるクエリ操作の例を取りあげます。。... include:：/includes/Driver-examples/examples-intro.rst

このページでは、MongoCollection.Find() メソッドを使用して、MongoDB C# ドライバーでnull 値をクエリする操作の例を紹介しています。

このページでは、Collection.Find 関数を使用して、MongoDB Go Driver で null 値をクエリする操作の例を紹介しています。

このページではnull com.mongodb.reactivestreams.client.MongoCollection.find メソッドを使用して、値に対してメソッドを使用した、MongoDB Java Reactive Streams ドライバーでのクエリ操作の例を取り上げます。。

このページでは、MongoDB Java Synchronous Driver で com.mongodb.client.MongoCollection.find メソッドを使用して、null 値をクエリする操作の例を紹介しています。

Tip

ドライバーが提供する com.mongodb.client.model.Filters ヘルパー　メソッドを使用すると、フィルタードキュメントの作成が簡単になります。このページでは、これらのメソッドを使用してフィルタードキュメントを作成する例を紹介します。

このページではnull MongoCollection.find() メソッドを使用して、値に対して実行されるクエリ操作の例を取りあげます。MongoDB Kotlin コルーチンドライバーで実行されるクエリ操作の例を取りあげます。

Tip

このページでは、motor.motor_asyncio.AsyncIOMotorCollection.find メソッドを使用して、Motor ドライバでnull 値をクエリする操作の例を紹介しています。

このページでは Collection.find() メソッドを使用して、null 値に対して MongoDB Node.js ドライバーで実行されるクエリ操作の例を取りあげます。

このページではnull MongoDB PHP ライブラリで MongoDB\\Collection::find() メソッドを使用して値に対して実行されるクエリ操作の例を取りあげます。

このページでは pymongo.collection.Collection.find メソッドを使用して、PyMongo Python ドライバーで null 値をクエリする操作の例を紹介しています。

このページでは MongoDB ::Collection::find()メソッドを使用して、 null値に対してMongoDB Ruby ドライバーで実行されるクエリ操作の例を取りあげます。

このページでは Collection.find() メソッドを使用して、null 値に対してメソッドを使用した、配列フィールドにおける MongoDB Scala ドライバーでのクエリ操作の例を取り上げます。

重要

MongoDB C ドライバーでBCON_NULLを使用して、MongoDB 内のnullまたは欠落しているフィールドをクエリします。

重要

MongoDB C# ドライバーで BsonNull.Value を使用して、MongoDB 内の null または欠落しているフィールドにクエリを実行できます。

重要

MongoDB Go ドライバーで nil を使用して、MongoDB 内の null または欠落しているフィールドに対してクエリを実行できます。

重要

Kotlin コルーチンドライバーでnullを使用して、MongoDB 内のnullまたは欠落しているフィールドをクエリします。

重要

MongoDBで null または欠落しているフィールドをクエリするために、Motorドライバで None を使用します。

重要

MongoDBで null または欠落しているフィールドをクエリするために、PyMongo Pythonドライバで None を使用します。

重要

MongoDB Ruby ドライバーでnilを使用して、MongoDB 内のnullまたは欠落しているフィールドをクエリします。

重要

MongoDB Scala ドライバーでBsonNull()を使用して、MongoDB 内のnullまたは欠落しているフィールドをクエリします。

db.inventory.insertMany([
   { _id: 1, item: null },
   { _id: 2 }
])

[
   { "_id": 1, "item": null },
   { "_id": 2 }
]

MongoDB Compass でドキュメントを挿入する手順については、「ドキュメントの挿入」を参照してください。

mongoc_collection_t *collection;
mongoc_bulk_operation_t *bulk;
bson_t *doc;
bool r;
bson_error_t error;
bson_t reply;
collection = mongoc_database_get_collection (db, "inventory");
bulk = mongoc_collection_create_bulk_operation_with_opts (collection, NULL);
doc = BCON_NEW (
   "_id", BCON_INT64 (1),
   "item", BCON_NULL);
r = mongoc_bulk_operation_insert_with_opts (bulk, doc, NULL, &error);
bson_destroy (doc);
if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}
doc = BCON_NEW ("_id", BCON_INT64 (2));
r = mongoc_bulk_operation_insert_with_opts (bulk, doc, NULL, &error);
bson_destroy (doc);
if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}
/* "reply" is initialized on success or error */
r = (bool) mongoc_bulk_operation_execute (bulk, &reply, &error);
if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
}

var documents = new[]
{
    new BsonDocument { { "_id", 1 }, { "item", BsonNull.Value } },
    new BsonDocument { { "_id", 2 } }
};
collection.InsertMany(documents);

docs := []interface{}{
	bson.D{
		{"_id", 1},
		{"item", nil},
	},
	bson.D{
		{"_id", 2},
	},
}
result, err := coll.InsertMany(context.TODO(), docs)

Publisher<Success> insertManyPublisher = collection.insertMany(asList(
        Document.parse("{'_id': 1, 'item': null}"),
        Document.parse("{'_id': 2}")
));

collection.insertMany(asList(
        Document.parse("{'_id': 1, 'item': null}"),
        Document.parse("{'_id': 2}")
));

collection.insertMany(
    listOf(
        Document("_id", 1)
            .append("item", null),
        Document("_id", 2)
    )
)

await db.inventory.insert_many([{"_id": 1, "item": None}, {"_id": 2}])

await db.collection('inventory').insertMany([{ _id: 1, item: null }, { _id: 2 }]);

$insertManyResult = $db->inventory->insertMany([
    ['_id' => 1, 'item' => null],
    ['_id' => 2],
]);

db.inventory.insert_many([{"_id": 1, "item": None}, {"_id": 2}])

client[:inventory].insert_many([{ _id: 1, item: nil },
                                { _id: 2 }])

collection.insertMany(Seq(
  Document("""{"_id": 1, "item": null}"""),
  Document("""{"_id": 2}""")
)).execute()

等価フィルター

{ item : null } クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

{ item, BCON_NULL } クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

Eq("item", BsonNull.Value)FilterDefinitionBuilder.Eq() を使用するクエリitem メソッドは、値がであるフィールドを含むか、null またはitem フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

item => nil クエリでは、値が nil である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

eq("item", null) クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

{ item : None } クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

[ item => undef ] クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

{ item => nil } クエリでは、値が nil である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

equal("item", BsonNull) クエリでは、値が null である item フィールドを含むか、または item フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

db.inventory.find( { item: null } )

次のクエリフィルタードキュメントをクエリバーにコピーし、[ Findをクリックします。

{ item: null }

mongoc_collection_t *collection;
bson_t *filter;
mongoc_cursor_t *cursor;
collection = mongoc_database_get_collection (db, "inventory");
filter = BCON_NEW ("item", BCON_NULL);
cursor = mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

var filter = Builders<BsonDocument>.Filter.Eq("item", BsonNull.Value);
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"item", nil},
	})

FindPublisher<Document> findPublisher = collection.find(eq("item", null));

FindIterable<Document> findIterable = collection.find(eq("item", null));

val findFlow = collection
    .find(eq("item", null))

cursor = db.inventory.find({"item": None})

const cursor = db.collection('inventory').find({
  item: null
});

$cursor = $db->inventory->find(['item' => null]);

cursor = db.inventory.find({"item": None})

client[:inventory].find(item: nil)

var findObservable = collection.find(equal("item", BsonNull()))

このクエリは、コレクション内の両方のドキュメントを返します。

非等価フィルター

存在し、かつ null 以外のフィールドをクエリするには、{ $ne : null } フィルターを使用します。{ item : { $ne : null } } クエリは、item フィールドが存在し、かつ、値が null 以外という条件に一致するドキュメントを絞り込みます。

db.inventory.find( { item: { $ne : null } } )

{ item: { $ne : null } }

filter = BCON_NEW ("item", BCON_NULL);
cursor = mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

var filter = Builders<BsonDocument>.Filter.Ne("item", BsonNull.Value);
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
  context.TODO(),
  bson.D{
    {"item", bson.D{"$ne": nil}},
  })

db.inventory.find( { item: { $ne : null} } )

collection.find(ne("item", null));

collection.find(ne("item", null))

cursor = db.inventory.find( { "item": { "$ne": None } } )

const cursor = db.collection('inventory')
  .find({ item: { $ne : null }
});

$cursor = $db->inventory->find(['item' => ['$ne' => null ]]);

cursor = db.inventory.find( { "item": { "$ne": None } } )

client[:inventory].find(item: { '$ne' => nil })

collection.find($ne("item", null));

型チェック

{ item : { $type: 10 } } クエリが一致するのは、値が null である item フィールドを含むドキュメントのみです。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

{ item, { $type, BCON_NULL } } クエリが一致するのは、値が null である item フィールドを含むドキュメントのみです。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

FilterDefinitionBuilder.Type() メソッドを使用する Type("item", BsonType.Null) クエリは、値が null である item フィールドを含むドキュメントのみに一致します。item フィールドの値は BSON 型 Null（BSON 型 10）です。

次のクエリは、値が BSON 型 Null（BSON 型 10）である item フィールドを含むというドキュメントのみに一致します。

type("item", BsonType.NULL) クエリが一致するのは、値が null である item フィールドを含むドキュメントのみです。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

type("item", BsonType.NULL)クエリは、値が null である item フィールドを含むドキュメントのみと一致します。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

type("item", BsonType.NULL)クエリは、値がnullであるitemフィールドを含むドキュメントのみと一致します。つまり、 itemフィールドの値はBSON Type Null （BSON Type 10 ）です。

[ item => [ $type => 10 ] ] クエリが一致するのは、値が null である item フィールドを含むドキュメントのみです。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

{ item => { $type => 10 } } クエリが一致するのは、値が null である item フィールドを含むドキュメントのみです。つまり、item フィールドの値は BSON 型 Null（BSON 型 10）です。

db.inventory.find( { item : { $type: 10 } } )

次のクエリフィルタードキュメントをクエリバーにコピーし、[Find] をクリックします。

{ item : { $type: 10 } }

mongoc_collection_t *collection;
bson_t *filter;
mongoc_cursor_t *cursor;
collection = mongoc_database_get_collection (db, "inventory");
filter = BCON_NEW (
   "item", "{",
   "$type", BCON_INT64 (10),
   "}");
cursor = mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

var filter = Builders<BsonDocument>.Filter.Type("item", BsonType.Null);
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"item", bson.D{
			{"$type", 10},
		}},
	})

findPublisher = collection.find(type("item", BsonType.NULL));

findIterable = collection.find(type("item", BsonType.NULL));

val findFlow = collection
    .find(type("item", BsonType.NULL))

cursor = db.inventory.find({"item": {"$type": 10}})

const cursor = db.collection('inventory').find({
  item: { $type: 10 }
});

$cursor = $db->inventory->find(['item' => ['$type' => 10]]);

cursor = db.inventory.find({"item": {"$type": 10}})

client[:inventory].find(item: { '$type' => 10 })

findObservable = collection.find(bsonType("item", BsonType.NULL))

このクエリは、itemフィールドに null 値があるドキュメントのみを返します。

有無のチェック

次の例では、フィールドを含まないドキュメントをクエリします。[1]

{ item : { $exists: false } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

{ item, { $exists, BCON_BOOL (false) } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

Exists("item", false) クエリは、FilterDefinitionBuilder.Exists() メソッドを使用して、item フィールドを含まないドキュメントに一致させます：

exists("item", false) クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

{ item : { $exists: False } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

{ item : { $exists: false } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

[ item => [ $exists => false ] ] クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

{ item : { $exists: False } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

{ item => { $exists => false } } クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

exists("item", exists = false) クエリでは、item フィールドを含まないという条件と一致するドキュメントを絞り込みます。

db.inventory.find( { item : { $exists: false } } )

次のクエリフィルタードキュメントをクエリバーにコピーし、[Find] をクリックします。

{ item : { $exists: false } }

mongoc_collection_t *collection;
bson_t *filter;
mongoc_cursor_t *cursor;
collection = mongoc_database_get_collection (db, "inventory");
filter = BCON_NEW (
   "item", "{",
   "$exists", BCON_BOOL (false),
   "}");
cursor = mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

必要に応じて、次のメソッドを呼び出して、開いているリソースもクリーンアップするようにします。

var filter = Builders<BsonDocument>.Filter.Exists("item", false);
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"item", bson.D{
			{"$exists", false},
		}},
	})

findPublisher = collection.find(exists("item", false));

findIterable = collection.find(exists("item", false));

val findFlow = collection
    .find(exists("item", false))

cursor = db.inventory.find({"item": {"$exists": False}})

const cursor = db.collection('inventory').find({
  item: { $exists: false }
});

$cursor = $db->inventory->find(['item' => ['$exists' => false]]);

cursor = db.inventory.find({"item": {"$exists": False}})

client[:inventory].find(item: { '$exists' => false })

findObservable = collection.find(exists("item", exists = false))

クエリは item フィールドを含んでいないドキュメントのみを返します。

Tip

以下も参照してください。

$type と $exists 演算子のリファレンスドキュメント。

[1]	クエリフィルター `$type: 0` を `$exists:false` の同義語として使用することはできなくなりました。null または欠落しているフィールドをクエリするには、「 Null または欠落フィールドのクエリ」を参照してください。

MongoDB Atlas を使用した Null または欠落フィールドのクエリ

このセクションの例では、訓練用サンプルデータセットを使用します。サンプルデータセットを MongoDB Atlas 配置にロードする方法について詳しくは、「サンプルデータのロード」を参照してください。

MongoDB Atlas で null または欠落しているフィールドをクエリするには、次の手順に従います。

MongoDB Atlas UI で、プロジェクトのClusters ページに移動します。

まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーションバーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーションバーの Projects メニューからプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。

コレクションに移動します。

サンプルデータを含むクラスターで、[ Browse Collections ] をクリックします。
左側のナビゲーションペインで、sample_training データベースを選択します。
companies コレクションを選択します。

空白のドキュメントを挿入します。

[Insert Document] ボタンをクリックして、ダイアログボックスが表示されたら、[Insert] をクリックして _id フィールドのみを含むドキュメントを挿入します。

クエリフィルタードキュメントを指定します。

null または欠損値を含むドキュメントを検索するには、Filter フィールドでクエリフィルタードキュメントを指定します。クエリフィルタードキュメントは、クエリ演算子を使用して検索条件を指定します。

MongoDB の各種クエリ演算子は、null 値を異なる方法で処理します。クエリフィルターを適用するには、次の各ドキュメントを Filter 検索バーにコピーし、[Apply] をクリックします。

次のクエリフィルターを使用して、null 値のある description フィールドを含むか description フィールドを含まないといういずれかの条件に一致するドキュメントを絞り込みます。

{ description : null }

次のクエリフィルタを使用して、description フィールドに null 値を含むドキュメントのみを一致させます。このフィルターは、フィールドの値が BSON 型 Null（BSON 型 10）であるという必須条件を指定します。

{ description : { $type: 10 } }

次のクエリフィルターを使用して、description フィールドを含まないドキュメントのみを一致させます。以前に挿入したドキュメントのみが表示されます。

{ description : { $exists: false } }

戻る

プロジェクトの結果

タイムアウト

Tip

Tip

重要

重要

重要

重要

重要

重要

重要

重要