Docs Menu

/

MongoDB 매뉴얼

/

문서 쿼리

이 페이지의 내용

컬렉션에서 모든 문서 선택

동등성 조건 지정
쿼리 연산자를 사용하여 조건 지정
AND 조건 지정
OR 조건 지정
AND 및 OR 조건 지정
MongoDB Atlas로 문서 쿼리
추가 쿼리 튜토리얼
행동
추가 메서드 및 옵션

MongoDB 5.0 은(는) 10월을 기준으로 수명이 2024 종료됩니다. 이 버전의 문서는 더 이상 지원되지 않습니다. 배포서버 서버를 업그레이드 5.0 하려면 MongoDB 를 참조하세요. 60 업그레이드 절차.

다음 메서드를 사용하여 MongoDB에서 문서를 쿼리할 수 있습니다:

프로그래밍 언어의 드라이버입니다.
MongoDB Atlas UI. 자세한 내용은 MongoDB Atlas로 문서 쿼리하기를 참조하세요.
MongoDB Compass

오른쪽 상단의 언어 선택 드롭다운 메뉴를 사용하여 다음 예시의 언어를 설정하거나 MongoDB Compass를 선택합니다.

이 페이지에서는 mongosh에서 db.collection.find() 메서드를 사용하는 쿼리 작업의 예를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지는 MongoDB Compass를 사용해 쿼리 작업을 실행하는 예시를 설명합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB C# 드라이버에서 MongoCollection.Find() 메서드를 사용한 쿼리 작업의 예시를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB Go 드라이버에서 Collection.Find 함수를 사용하는 쿼리 작업의 예시를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB Java Reactive Streams 드라이버에서 com.mongodb.reactivestreams.client.MongoCollection.find 메서드를 사용하여 쿼리 작업의 예시를 보여줍니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB Java Synchronous 드라이버에서 com.mongodb.client.MongoCollection.find 메서드를 사용하여 쿼리 작업의 예시를 보여줍니다.

팁

이 드라이버는 필터 문서를 쉽게 만들 수 있도록 com.mongodb.client.model.Filters 헬퍼 메서드를 제공합니다. 이 페이지의 예시에서는 이러한 방법을 사용하여 필터 문서를 생성합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 Motor 드라이버에서 motor.motor_asyncio.AsyncIOMotorCollection.find 메서드를 사용한 쿼리 작업의 예를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지는 MongoDB Node.js 드라이버에서 Collection.find() 메서드를 사용해 쿼리 작업을 실행하는 예시를 설명합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB Perl 드라이버에서 MongoDB::Collection::find() 메서드를 사용하는 쿼리 작업의 예시를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB PHP 라이브러리에서 MongoDB\\Collection::find() 메서드를 사용하여 쿼리 작업의 예시를 보여줍니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지는 PyMongo Python 드라이버의 pymongo.collection.Collection.find 메서드를 사용한 쿼리 작업의 예를 제공합니다..

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 MongoDB Ruby 드라이버에서 Mongo::Collection#find() 메서드를 사용하여 쿼리 작업의 예시를 보여줍니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

이 페이지에서는 collection.find() 메서드를 사용하는 MongoDB Scala 드라이버 내의 작업 예시를 제공합니다.

이 페이지의 예시에서는 inventory 컬렉션을 사용합니다. MongoDB 인스턴스의 테스트 데이터베이스에 연결한 다음 inventory 컬렉션을 만듭니다:

db.inventory.insertMany([
   { item: "journal", qty: 25, size: { h: 14, w: 21, uom: "cm" }, status: "A" },
   { item: "notebook", qty: 50, size: { h: 8.5, w: 11, uom: "in" }, status: "A" },
   { item: "paper", qty: 100, size: { h: 8.5, w: 11, uom: "in" }, status: "D" },
   { item: "planner", qty: 75, size: { h: 22.85, w: 30, uom: "cm" }, status: "D" },
   { item: "postcard", qty: 45, size: { h: 10, w: 15.25, uom: "cm" }, status: "A" }
]);

[
    { "item": "journal", "qty": 25, "size": { "h": 14, "w": 21, "uom": "cm" }, "status": "A" },
    { "item": "notebook", "qty": 50, "size": { "h": 8.5, "w": 11, "uom": "in" }, "status": "A" },
    { "item": "paper", "qty": 100, "size": { "h": 8.5, "w": 11, "uom": "in" }, "status": "D" },
    { "item": "planner", "qty": 75, "size": { "h": 22.85, "w": 30, "uom": "cm" }, "status": "D" },
    { "item": "postcard", "qty": 45, "size": { "h": 10, "w": 15.25, "uom": "cm" }, "status": "A" }
]

MongoDB Compass에서 문서를 삽입하는 방법은 문서 삽입하기를 참조하세요.

var documents = new BsonDocument[]
{
    new BsonDocument
    {
        { "item", "journal" },
        { "qty", 25 },
        { "size", new BsonDocument { { "h", 14 }, { "w", 21 }, {  "uom", "cm"} } },
        { "status", "A" }
    },
    new BsonDocument
    {
        { "item", "notebook" },
        { "qty", 50 },
        { "size", new BsonDocument { { "h",  8.5 }, { "w", 11 }, {  "uom", "in"} } },
        { "status", "A" }
    },
    new BsonDocument
    {
        { "item", "paper" },
        { "qty", 100 },
        { "size", new BsonDocument { { "h",  8.5 }, { "w", 11 }, {  "uom", "in"} } },
        { "status", "D" }
    },
    new BsonDocument
    {
        { "item", "planner" },
        { "qty", 75 },
        { "size", new BsonDocument { { "h", 22.85 }, { "w", 30  }, {  "uom", "cm"} } },
        { "status", "D" }
    },
    new BsonDocument
    {
        { "item", "postcard" },
        { "qty", 45 },
        { "size", new BsonDocument { { "h", 10 }, { "w", 15.25 }, {  "uom", "cm"} } },
        { "status", "A" }
    },
};
collection.InsertMany(documents);

docs := []interface{}{
	bson.D{
		{"item", "journal"},
		{"qty", 25},
		{"size", bson.D{
			{"h", 14},
			{"w", 21},
			{"uom", "cm"},
		}},
		{"status", "A"},
	},
	bson.D{
		{"item", "notebook"},
		{"qty", 50},
		{"size", bson.D{
			{"h", 8.5},
			{"w", 11},
			{"uom", "in"},
		}},
		{"status", "A"},
	},
	bson.D{
		{"item", "paper"},
		{"qty", 100},
		{"size", bson.D{
			{"h", 8.5},
			{"w", 11},
			{"uom", "in"},
		}},
		{"status", "D"},
	},
	bson.D{
		{"item", "planner"},
		{"qty", 75},
		{"size", bson.D{
			{"h", 22.85},
			{"w", 30},
			{"uom", "cm"},
		}},
		{"status", "D"},
	},
	bson.D{
		{"item", "postcard"},
		{"qty", 45},
		{"size", bson.D{
			{"h", 10},
			{"w", 15.25},
			{"uom", "cm"},
		}},
		{"status", "A"},
	},
}
result, err := coll.InsertMany(context.TODO(), docs)

Publisher<Success> insertManyPublisher = collection.insertMany(asList(
        Document.parse("{ item: 'journal', qty: 25, size: { h: 14, w: 21, uom: 'cm' }, status: 'A' }"),
        Document.parse("{ item: 'notebook', qty: 50, size: { h: 8.5, w: 11, uom: 'in' }, status: 'A' }"),
        Document.parse("{ item: 'paper', qty: 100, size: { h: 8.5, w: 11, uom: 'in' }, status: 'D' }"),
        Document.parse("{ item: 'planner', qty: 75, size: { h: 22.85, w: 30, uom: 'cm' }, status: 'D' }"),
        Document.parse("{ item: 'postcard', qty: 45, size: { h: 10, w: 15.25, uom: 'cm' }, status: 'A' }")
));

collection.insertMany(asList(
        Document.parse("{ item: 'journal', qty: 25, size: { h: 14, w: 21, uom: 'cm' }, status: 'A' }"),
        Document.parse("{ item: 'notebook', qty: 50, size: { h: 8.5, w: 11, uom: 'in' }, status: 'A' }"),
        Document.parse("{ item: 'paper', qty: 100, size: { h: 8.5, w: 11, uom: 'in' }, status: 'D' }"),
        Document.parse("{ item: 'planner', qty: 75, size: { h: 22.85, w: 30, uom: 'cm' }, status: 'D' }"),
        Document.parse("{ item: 'postcard', qty: 45, size: { h: 10, w: 15.25, uom: 'cm' }, status: 'A' }")
));

await db.inventory.insert_many(
    [
        {
            "item": "journal",
            "qty": 25,
            "size": {"h": 14, "w": 21, "uom": "cm"},
            "status": "A",
        },
        {
            "item": "notebook",
            "qty": 50,
            "size": {"h": 8.5, "w": 11, "uom": "in"},
            "status": "A",
        },
        {
            "item": "paper",
            "qty": 100,
            "size": {"h": 8.5, "w": 11, "uom": "in"},
            "status": "D",
        },
        {
            "item": "planner",
            "qty": 75,
            "size": {"h": 22.85, "w": 30, "uom": "cm"},
            "status": "D",
        },
        {
            "item": "postcard",
            "qty": 45,
            "size": {"h": 10, "w": 15.25, "uom": "cm"},
            "status": "A",
        },
    ]
)

await db.collection('inventory').insertMany([
  {
    item: 'journal',
    qty: 25,
    size: { h: 14, w: 21, uom: 'cm' },
    status: 'A'
  },
  {
    item: 'notebook',
    qty: 50,
    size: { h: 8.5, w: 11, uom: 'in' },
    status: 'A'
  },
  {
    item: 'paper',
    qty: 100,
    size: { h: 8.5, w: 11, uom: 'in' },
    status: 'D'
  },
  {
    item: 'planner',
    qty: 75,
    size: { h: 22.85, w: 30, uom: 'cm' },
    status: 'D'
  },
  {
    item: 'postcard',
    qty: 45,
    size: { h: 10, w: 15.25, uom: 'cm' },
    status: 'A'
  }
]);

$db->coll("inventory")->insert_many(
    [
        {
            item   => "journal",
            qty    => 25,
            size   => { h => 14, w => 21, uom => "cm" },
            status => "A"
        },
        {
            item   => "notebook",
            qty    => 50,
            size   => { h => 8.5, w => 11, uom => "in" },
            status => "A"
        },
        {
            item   => "paper",
            qty    => 100,
            size   => { h => 8.5, w => 11, uom => "in" },
            status => "D"
        },
        {
            item   => "planner",
            qty    => 75,
            size   => { h => 22.85, w => 30, uom => "cm" },
            status => "D"
        },
        {
            item   => "postcard",
            qty    => 45,
            size   => { h => 10, w => 15.25, uom => "cm" },
            status => "A"
        }
    ]
);

$insertManyResult = $db->inventory->insertMany([
    [
        'item' => 'journal',
        'qty' => 25,
        'size' => ['h' => 14, 'w' => 21, 'uom' => 'cm'],
        'status' => 'A',
    ],
    [
        'item' => 'notebook',
        'qty' => 50,
        'size' => ['h' => 8.5, 'w' => 11, 'uom' => 'in'],
        'status' => 'A',
    ],
    [
        'item' => 'paper',
        'qty' => 100,
        'size' => ['h' => 8.5, 'w' => 11, 'uom' => 'in'],
        'status' => 'D',
    ],
    [
        'item' => 'planner',
        'qty' => 75,
        'size' => ['h' => 22.85, 'w' => 30, 'uom' => 'cm'],
        'status' => 'D',
    ],
    [
        'item' => 'postcard',
        'qty' => 45,
        'size' => ['h' => 10, 'w' => 15.25, 'uom' => 'cm'],
        'status' => 'A',
    ],
]);

db.inventory.insert_many(
    [
        {
            "item": "journal",
            "qty": 25,
            "size": {"h": 14, "w": 21, "uom": "cm"},
            "status": "A",
        },
        {
            "item": "notebook",
            "qty": 50,
            "size": {"h": 8.5, "w": 11, "uom": "in"},
            "status": "A",
        },
        {
            "item": "paper",
            "qty": 100,
            "size": {"h": 8.5, "w": 11, "uom": "in"},
            "status": "D",
        },
        {
            "item": "planner",
            "qty": 75,
            "size": {"h": 22.85, "w": 30, "uom": "cm"},
            "status": "D",
        },
        {
            "item": "postcard",
            "qty": 45,
            "size": {"h": 10, "w": 15.25, "uom": "cm"},
            "status": "A",
        },
    ]
)

client[:inventory].insert_many([{ item: 'journal',
                                  qty: 25,
                                  size: { h: 14, w: 21, uom: 'cm' },
                                  status: 'A' },
                                { item: 'notebook',
                                  qty: 50,
                                  size: { h: 8.5, w: 11, uom: 'in' },
                                  status: 'A' },
                                { item: 'paper',
                                  qty: 100,
                                  size: { h: 8.5, w: 11, uom: 'in' },
                                  status: 'D' },
                                { item: 'planner',
                                  qty: 75,
                                  size: { h: 22.85, w: 30, uom: 'cm' },
                                  status: 'D' },
                                { item: 'postcard',
                                  qty: 45,
                                  size: { h: 10, w: 15.25, uom: 'cm' },
                                  status: 'A' }
                               ])

collection.insertMany(Seq(
  Document("""{ item: "journal", qty: 25, size: { h: 14, w: 21, uom: "cm" }, status: "A" }"""),
  Document("""{ item: "notebook", qty: 50, size: { h: 8.5, w: 11, uom: "in" }, status: "A" }"""),
  Document("""{ item: "paper", qty: 100, size: { h: 8.5, w: 11, uom: "in" }, status: "D" }"""),
  Document("""{ item: "planner", qty: 75, size: { h: 22.85, w: 30, uom: "cm" }, status: "D" }"""),
  Document("""{ item: "postcard", qty: 45, size: { h: 10, w: 15.25, uom: "cm" }, status: "A" }""")
)).execute()

컬렉션에서 모든 문서 선택

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 빈 문서를 쿼리 필터 매개 변수로 쿼리 표시줄에 전달합니다. 쿼리 필터 매개 변수는 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

컬렉션의 모든 문서를 선택하려면 find 메서드에 빈 문서를 쿼리 필터 매개변수로 전달합니다. 쿼리 필터 매개변수가 선택 기준을 결정합니다.

db.inventory.find( {} )

Compass 컬렉션의 모든 문서 선택

var filter = Builders<BsonDocument>.Filter.Empty;
var result = collection.Find(filter).ToList();

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

FindPublisher<Document> findPublisher = collection.find(new Document());

FindIterable<Document> findIterable = collection.find(new Document());

cursor = db.inventory.find({})

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

$cursor = $db->coll("inventory")->find( {} );

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

cursor = db.inventory.find({})

client[:inventory].find({})

var findObservable = collection.find(Document())

이 작업은 다음 SQL 문에 해당하는 필터 조건자 {}를 사용합니다.

SELECT * FROM inventory

메서드 구문에 대한 자세한 내용은 find()를 참조하세요.

MongoDB Compass 쿼리 표시줄(Query Bar)에 대한 자세한 내용은 다음을 참조하세요.

메서드 구문에 관한 자세한 내용은 Find()를 참조하세요.

메서드 구문에 대한 자세한 내용은 com.mongodb.reactivestreams.client.MongoCollection.find를 참조하세요.

메서드 구문에 대한 자세한 내용은 com.mongodb.client.MongoCollection.find를 참조하세요.

find() 메서드에서 지원되는 옵션은 find()를 참조하세요.

메서드 구문에 대한 자세한 내용은 find()

메서드 구문에 대한 자세한 내용은 find()를 참조하세요.

메서드 구문에 관한 자세한 내용은 find를 참조하세요.

메서드 구문에 대한 자세한 내용은 find()를 참조하세요.

메서드 구문에 대한 자세한 내용은 collection.find()을 참조하세요.

동등성 조건 지정

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field>:<value> 표현식을 사용하세요.

{ <field1>: <value1>, ... }

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field>:<value> 표현식을 사용하세요.

{ <field1>: <value1>, ... }

동등 조건을 지정하려면 Eq 메서드를 사용하여 필터를 구성합니다.

Builders<BsonDocument>.Filter.Eq(<field>, <value>);

동등 조건을 지정하려면 com.mongodb.Client.Model.Filters.eq 메서드를 사용하여 쿼리 필터 문서를 만듭니다.

and(eq( <field1>, <value1>), eq( <field2>, <value2>) ...)

동일성 조건을 지정하려면 com.mongodb.client.model.Filters.eq_ 메서드를 사용하여 쿼리 필터 문서를 만듭니다.

and(eq( <field1>, <value1>), eq( <field2>, <value2>) ...)

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field>:<value> 표현식을 사용하세요.

{ <field1>: <value1>, ... }

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field>:<value> 표현식을 사용하세요.

{ <field1>: <value1>, ... }

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field> => <value> 표현식을 사용하세요.

{ <field1> => <value1>, ... }

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field> => <value> 표현식을 사용하세요.

[ <field1> => <value1>, ... ]

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field>:<value> 표현식을 사용하세요.

{ <field1>: <value1>, ... }

동일성 조건을 지정하려면 쿼리 필터 문서에서 <field> => <value> 표현식을 사용하세요.

{ <field1> => <value1>, ... }

동일성 조건을 지정하려면 com.mongodb.client.model.Filters.eq_ 메서드를 사용하여 쿼리 필터 문서를 만듭니다.

and(equal(<field1>, <value1>), equal(<field2>, <value2>) ...)

다음 예시에서는 inventory 컬렉션에서 status가 "D"와 동일한 모든 문서를 선택합니다.

db.inventory.find( { status: "D" } )

다음 필터를 Compass 쿼리 표시줄에 복사하고 Find를 클릭합니다.

{ status: "D" }

var filter = Builders<BsonDocument>.Filter.Eq("status", "D");
var result = collection.Find(filter).ToList();

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

findPublisher = collection.find(eq("status", "D"));

findIterable = collection.find(eq("status", "D"));

cursor = db.inventory.find({"status": "D"})

const cursor = db.collection('inventory').find({ status: 'D' });

$cursor = $db->coll("inventory")->find( { status => "D" } );

$cursor = $db->inventory->find(['status' => 'D']);

cursor = db.inventory.find({"status": "D"})

client[:inventory].find(status: 'D')

findObservable = collection.find(equal("status", "D"))

이 작업은 다음 SQL 문에 해당하는 필터 조건자 { status: "D" }를 사용합니다.

SELECT * FROM inventory WHERE status = "D"

참고

MongoDB Compass 쿼리 표시줄은 포함된 하위 문서의 키를 포함하여 collection 문서에 있는 키를 기반으로 현재 쿼리를 자동 완성합니다.

쿼리 연산자를 사용하여 조건 지정

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1>: { <operator1>: <value1> }, ... }

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1>: { <operator1>: <value1> }, ... }

MongoDB는 동등 필터 외에도 필터 조건을 지정하기 위한 다양한 쿼리 연산자를 제공합니다. FilterDefinitionBuilder 메서드를 사용하여 필터 문서를 만듭니다. 예시:

var builder = Builders<BsonDocument>.Filter;
builder.And(builder.Eq(<field1>, <value1>), builder.Lt(<field2>, <value2>));

MongoDB는 동등 조건 외에도 필터 조건을 지정하기 위한 다양한 쿼리 연산자를 제공합니다. com.mongodb.client.model.Filters 헬퍼 메서드를 사용하여 필터 문서를 쉽게 만들 수 있습니다. 예시:

and(gte(<field1>, <value1>), lt(<field2>, <value2>), eq(<field3>, <value3>))

MongoDB는 동등 조건 외에도 필터 조건을 지정하기 위한 다양한 쿼리 연산자를 제공합니다. com.mongodb.client.model.Filters 헬퍼 메서드를 사용하여 필터 문서를 쉽게 만들 수 있습니다. 예시:

and(gte(<field1>, <value1>), lt(<field2>, <value2>), eq(<field3>, <value3>))

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1>: { <operator1>: <value1> }, ... }

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1>: { <operator1>: <value1> }, ... }

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1> => { <operator1> => <value1> }, ... }

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

[ <field1> => [ <operator1> => <value1> ], ... ]

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1>: { <operator1>: <value1> }, ... }

쿼리 필터 문서에서는 쿼리 연산자를 사용하여 다음 형식의 조건을 지정할 수 있습니다.

{ <field1> => { <operator1> => <value1> }, ... }

MongoDB는 동등 조건 외에도 필터 조건을 지정하기 위한 다양한 쿼리 연산자를 제공합니다. com.mongodb.client.model.Filters_ 헬퍼 메서드를 사용하여 필터 문서를 쉽게 만들 수 있습니다. 예시:

and(gte(<field1>, <value1>), lt(<field2>, <value2>), equal(<field3>, <value3>))

다음 예시에서는 inventory 컬렉션에서 status가 "A"나 "D"와 동일한 모든 문서를 조회합니다.

db.inventory.find( { status: { $in: [ "A", "D" ] } } )

다음 필터를 Compass 쿼리 표시줄에 복사하고 Find를 클릭합니다.

{ status: { $in: [ "A", "D" ] } }

var filter = Builders<BsonDocument>.Filter.In("status", new[] { "A", "D" });
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{{"status", bson.D{{"$in", bson.A{"A", "D"}}}}})

findPublisher = collection.find(in("status", "A", "D"));

findIterable = collection.find(in("status", "A", "D"));

cursor = db.inventory.find({"status": {"$in": ["A", "D"]}})

const cursor = db.collection('inventory').find({
  status: { $in: ['A', 'D'] }
});

$cursor = $db->coll("inventory")->find( { status => { '$in' => [ "A", "D" ] } } );

$cursor = $db->inventory->find(['status' => ['$in' => ['A', 'D']]]);

cursor = db.inventory.find({"status": {"$in": ["A", "D"]}})

client[:inventory].find(status: { '$in' => [ 'A', 'D' ]})

findObservable = collection.find(in("status", "A", "D"))

참고

$or 연산자를 사용하여 이 쿼리를 표현할 수 있지만, 동일한 필드에 동등성 검사를 수행할 때에는 $or 연산자 대신 $in 연산자를 사용합니다.

이 작업은 다음 SQL 문에 해당하는 필터 조건자 { status: { $in: [ "A", "D" ] } }를 사용합니다.

SELECT * FROM inventory WHERE status in ("A", "D")

MongoDB 쿼리 연산자의 전체 목록은 쿼리 및 프로젝션 연산자 문서에서 확인 가능합니다.

`AND` 조건 지정

복합 쿼리는 컬렉션의 문서에 포함된 하나 이상의 필드에 조건을 지정할 수 있습니다. 암시적으로, 논리 접속사 AND는 복합 쿼리의 절을 연결하여 쿼리가 컬렉션에서 모든 조건에 일치하는 문서를 선택하도록 합니다.

다음 예시에서는 inventory 컬렉션에서 status가 "A"와 같고 qty가 ($lt)30보다 작은 문서를 모두 조회합니다.

db.inventory.find( { status: "A", qty: { $lt: 30 } } )

다음 필터를 Compass 쿼리 표시줄에 복사하고 Find를 클릭합니다.

{ status: "A", qty: { $lt: 30 } }

var builder = Builders<BsonDocument>.Filter;
var filter = builder.And(builder.Eq("status", "A"), builder.Lt("qty", 30));
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"status", "A"},
		{"qty", bson.D{{"$lt", 30}}},
	})

findPublisher = collection.find(and(eq("status", "A"), lt("qty", 30)));

findIterable = collection.find(and(eq("status", "A"), lt("qty", 30)));

cursor = db.inventory.find({"status": "A", "qty": {"$lt": 30}})

const cursor = db.collection('inventory').find({
  status: 'A',
  qty: { $lt: 30 }
});

$cursor = $db->coll("inventory")->find( { status => "A", qty => { '$lt' => 30 } } );

$cursor = $db->inventory->find([
    'status' => 'A',
    'qty' => ['$lt' => 30],
]);

cursor = db.inventory.find({"status": "A", "qty": {"$lt": 30}})

client[:inventory].find(status: 'A', qty: { '$lt' => 30 })

findObservable = collection.find(and(equal("status", "A"), lt("qty", 30)))

이 작업은 다음 SQL 문에 해당하는 필터 조건자 { status: "A", qty: { $lt: 30 } }를 사용합니다.

SELECT * FROM inventory WHERE status = "A" AND qty < 30

다른 MongoDB 비교 연산자는 비교 연산자에서 확인 가능합니다.

`OR` 조건 지정

$or 연산자를 사용하면 논리 접속사 OR로 각 절을 연결하는 복합 쿼리를 지정하여 쿼리는 컬렉션에서 적어도 하나의 조건과 일치하는 문서를 선택합니다.

다음 예시에서는 컬렉션에서 status가 "A"와 같거나 qty가 ($lt)30보다 작은 모든 문서를 검색합니다.

db.inventory.find( { $or: [ { status: "A" }, { qty: { $lt: 30 } } ] } )

다음 필터를 Compass 쿼리 표시줄에 복사하고 Find를 클릭합니다.

{ $or: [ { status: "A" }, { qty: { $lt: 30 } } ] }

var builder = Builders<BsonDocument>.Filter;
var filter = builder.Or(builder.Eq("status", "A"), builder.Lt("qty", 30));
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"$or",
			bson.A{
				bson.D{{"status", "A"}},
				bson.D{{"qty", bson.D{{"$lt", 30}}}},
			}},
	})

findPublisher = collection.find(or(eq("status", "A"), lt("qty", 30)));

findIterable = collection.find(or(eq("status", "A"), lt("qty", 30)));

cursor = db.inventory.find({"$or": [{"status": "A"}, {"qty": {"$lt": 30}}]})

const cursor = db.collection('inventory').find({
  $or: [{ status: 'A' }, { qty: { $lt: 30 } }]
});

$cursor = $db->coll("inventory")->find(
    { '$or' => [ { status => "A" }, { qty => { '$lt' => 30 } } ] }
);

$cursor = $db->inventory->find([
    '$or' => [
        ['status' => 'A'],
        ['qty' => ['$lt' => 30]],
    ],
]);

cursor = db.inventory.find({"$or": [{"status": "A"}, {"qty": {"$lt": 30}}]})

client[:inventory].find('$or' => [{ status: 'A' },
                                  { qty: { '$lt' => 30 } }
                                 ])

findObservable = collection.find(or(equal("status", "A"), lt("qty", 30)))

이 작업은 다음 SQL 문에 해당하는 필터 조건자 { $or: [ { status: 'A' }, { qty: { $lt: 30 } } ] }를 사용합니다.

SELECT * FROM inventory WHERE status = "A" OR qty < 30

참고

비교 연산자를 사용하는 쿼리에는 유형 괄호가 적용됩니다.

`AND` 및 `OR` 조건 지정

다음 예시에서 복합 쿼리 문서는 status가 "A"와 같고 qty가 ($lt) 30보다 작거나 또는 item이(가) p로 시작하는 조건 중 하나를 만족하는 모든 문서를 선택합니다.

db.inventory.find( {
     status: "A",
     $or: [ { qty: { $lt: 30 } }, { item: /^p/ } ]
} )

다음 필터를 Compass 쿼리 표시줄에 복사하고 Find를 클릭합니다.

{ status: "A", $or: [ { qty: { $lt: 30 } }, { item: /^p/ } ] }

var builder = Builders<BsonDocument>.Filter;
var filter = builder.And(
    builder.Eq("status", "A"),
    builder.Or(builder.Lt("qty", 30), builder.Regex("item", new BsonRegularExpression("^p"))));
var result = collection.Find(filter).ToList();

cursor, err := coll.Find(
	context.TODO(),
	bson.D{
		{"status", "A"},
		{"$or", bson.A{
			bson.D{{"qty", bson.D{{"$lt", 30}}}},
			bson.D{{"item", bson.Regex{Pattern: "^p", Options: ""}}},
		}},
	})

findPublisher = collection.find(
        and(eq("status", "A"),
                or(lt("qty", 30), regex("item", "^p")))
);

findIterable = collection.find(
        and(eq("status", "A"),
                or(lt("qty", 30), regex("item", "^p")))
);

cursor = db.inventory.find(
    {"status": "A", "$or": [{"qty": {"$lt": 30}}, {"item": {"$regex": "^p"}}]}
)

const cursor = db.collection('inventory').find({
  status: 'A',
  $or: [{ qty: { $lt: 30 } }, { item: { $regex: '^p' } }]
});

$cursor = $db->coll("inventory")->find(
    {
        status => "A",
        '$or'  => [ { qty => { '$lt' => 30 } }, { item => { '$regex' => "^p" } } ]
    }
);

$cursor = $db->inventory->find([
    'status' => 'A',
    '$or' => [
        ['qty' => ['$lt' => 30]],
        // Alternatively: ['item' => new \MongoDB\BSON\Regex('^p')]
        ['item' => ['$regex' => '^p']],
    ],
]);

cursor = db.inventory.find(
    {"status": "A", "$or": [{"qty": {"$lt": 30}}, {"item": {"$regex": "^p"}}]}
)

client[:inventory].find(status: 'A',
                        '$or' => [{ qty: { '$lt' => 30 } },
                                  { item: { '$regex' => BSON::Regexp::Raw.new('^p') } }
                        ])

findObservable = collection.find(and(
  equal("status", "A"),
  or(lt("qty", 30), regex("item", "^p")))
)

이 작업이 이용하는 필터 술어

{
   status: 'A',
   $or: [
     { qty: { $lt: 30 } }, { item: { $regex: '^p' } }
   ]
}

는 다음 SQL 문에 해당합니다.

SELECT * FROM inventory WHERE status = "A" AND ( qty < 30 OR item LIKE "p%")

참고

MongoDB는 문자열 패턴 일치를 수행하기 위해 정규 표현식 $regex 쿼리를 지원합니다.

MongoDB Atlas로 문서 쿼리

이 섹션의 예에서는 샘플 영화 데이터세트를 사용합니다. MongoDB Atlas 배포서버에 샘플 데이터세트를 로드하는 방법을 알아보려면 샘플 데이터 로드를 참조하세요.

MongoDB Atlas의 쿼리에서 반환할 필드를 프로젝트하려면 다음 단계를 따르세요.

1

MongoDB Atlas UI에서 Clusters 프로젝트의 페이지로 이동합니다.

아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.

2

컬렉션으로 이동합니다.

샘플 데이터가 포함된 클러스터의 경우 Browse Collections 을 클릭합니다.
왼쪽 탐색 창에서 sample_mflix 데이터베이스를 선택합니다.
movies 컬렉션을 선택합니다.

3

Filter 필드 지정

Filter 필드에 쿼리 필터 문서를 지정합니다. 쿼리 필터 문서는 쿼리 연산자를 사용하여 검색 조건을 지정합니다.

다음 쿼리 필터 문서를 Filter 검색 바에 복사합니다.

{ year: 1924 }

4

클릭 Apply

이 쿼리 필터는 sample_mflix.movies 컬렉션에서 year 필드가 1924와 일치하는 모든 문서를 반환합니다.

추가 쿼리 튜토리얼

추가 쿼리 예시는 아래에서 확인 가능합니다.

행동

커서

db.collection.find() 메서드는 일치하는 문서에 커서를 반환합니다.

MongoDB Compass Find 작업은 찾기 쿼리를 기반으로 컬렉션의 일치하는 문서에 대한 커서를 엽니다.

MongoDB Compass 샘플링에 관한 자세한 내용은 Compass FAQ를 참조하세요.

MongoCollection.Find() 메서드는 일치하는 문서에 커서를 반환합니다. 커서 반복에 대해서는 MongoDB C# 드라이버 설명서를 참조하세요.

Collection.Find 함수는 일치하는 문서에 커서를 반환합니다. 자세한 내용은 커서 문서를 참조하세요.

com.mongodb.reactivestreams.client.MongoCollection.find는 com.mongodb.reactivestreams.client.FindPublisher 인터페이스의 인스턴스를 반환합니다.

com.mongodb.client.MongoCollection.find 메서드는 com.mongodb.client.FindIterable 인터페이스의 인스턴스를 반환합니다.

Collection.find() 메서드는 커서를 반환합니다.

MongoDB::Collection::find() 메서드는 일치하는 문서에 커서를 반환합니다. 커서 반복에 대해서는 MongoDB Perl 드라이버 설명서를 참조하세요.

MongoDB\\Collection::find() 메서드는 일치하는 문서에 커서를 반환합니다. 커서 반복에 대해서는 MongoDB PHP 라이브러리 문서를 참조하세요.

이 pymongo.collection.Collection.find 메서드는 일치하는 문서에 커서를 반환합니다. 커서 반복에 대해서는 PyMongo 설명서를 참조하세요.

Mongo::Collection#find() 메서드는 Enumerable인 CollectionView를 반환합니다. 커서는 예를 들어 #to_a() 또는 #each()을(를) 호출하여 View이(가) 열거될 때 생성됩니다. View에서 #to_enum()을(를) 호출하여 Enumerator을(를) 받을 수도 있습니다. 커서 반복에 대해서는 Ruby 드라이버 API 문서를 참조하세요.

collection.find() 메서드는 find Observable을 반환합니다.

격리 읽기

버전 3.2에 새로 추가되었습니다.

복제본 세트 및 복제본 세트 샤드에 대한 읽기의 경우, 클라이언트는 읽기 고려를 통해 읽기에 대한 격리 수준을 선택할 수 있습니다. 자세한 내용은 Read Concern을 참조하십시오.

결과 형식 쿼리

MongoDB 드라이버 또는 mongosh를 사용하여 찾기 작업을 실행하면 이 명령은 쿼리 결과를 관리하는 커서를 반환합니다. 쿼리 결과는 문서 배열로 반환되지 않습니다.

커서에서 문서를 반복하는 방법을 알아보려면 해당 드라이버의 설명서를 참조하세요. mongosh를 사용하는 경우 mongosh에서 커서 반복하기를 참조하세요.

추가 메서드 및 옵션

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

db.collection.findOne()
애그리게이션 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다.

참고

db.collection.findOne() 메서드는 읽기 작업을 수행하여 단일 문서를 반환합니다. 내부적으로 db.collection.findOne() 메서드는 제한이 1인 db.collection.find() 메서드입니다.

filter 외에도 MongoDB Compass를 사용하면 다음 옵션을 쿼리 표시줄에 전달할 수 있습니다.

프로젝트	결과 데이터에서 반환할 필드를 지정합니다.
Sort	반환된 문서의 정렬 순서를 지정합니다.
Skip	결과 집합을 반환하기 전에 건너뛸 문서의 개수를 지정합니다.
Limit	반환할 문서의 최대 개수를 지정합니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

MongoCollection.FindOne()
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. MongoDB C# 드라이버의 LINQ 설명서를 참조하세요.

참고

MongoCollection.FindOne() 메서드는 읽기 작업을 수행해 단일 문서를 반환하기도 합니다. 내부적으로 MongoCollection.FindOne() 메서드는 제한이 1로 설정된 MongoCollection.Find() 메서드입니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

Collection.FindOne
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. Collection.Aggregate를 참조하세요.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. 자세한 내용은 com.mongodb.reactivestreams.client.MongoCollection.aggregate를 참조하세요.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. Java 동기식 드라이버 집계 예시를 참조하세요.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

Collection.findOne()
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. 자세한 내용은 MongoDB Node.js 드라이버의 집계 튜토리얼을 참조하세요.

참고

Collection.findOne() 메서드는 읽기 작업을 수행해 단일 문서를 반환하기도 합니다. 내부적으로 Collection.findOne() 메서드는 제한이 1로 설정된 Collection.find()입니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

MongoDB::Collection::find_one()
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. MongoDB Perl 드라이버의 집계 예시를 참조하세요.

참고

MongoDB::Collection::find_one() 메서드는 읽기 작업을 수행해 단일 문서를 반환하기도 합니다. 내부적으로 MongoDB: :Collection: :find_one () 메서드는 제한이 1인 MongoDB: :Collection: :find () 메서드입니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

MongoDB\\Collection::findOne()
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. MongoDB PHP 라이브러리의 집계 예시를 참조하세요.

참고

MongoDB\\Collection::findOne() 메서드는 읽기 작업을 수행하여 단일 문서를 반환하기도 합니다. 내부적으로 MongoDB\\Collection::findOne() 메서드는 제한이 1인 MongoDB\\Collection::find() 메서드입니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

pymongo.collection.Collection.find_one
집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. PyMongo 집계 예시를 참조하세요.

참고

pymongo.collection.Collection.find_one 메서드는 읽기 작업을 수행하여 단일 문서를 반환하기도 합니다. 내부적으로 pymongo.collection.Collection.find_one 메서드는 제한이 1인 pymongo.collection.Collection.find 메서드입니다.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. MongoDB Ruby 드라이버의 집계 예시를 참조하세요.

다음과 같은 방법으로도 컬렉션에서 문서를 읽을 수 있습니다.

집계 파이프라인에서 $match 파이프라인 단계는 MongoDB 쿼리에 대한 액세스를 제공합니다. MongoDB Scala 드라이버의 집계 메서드를 참조하세요.

돌아가기

방법

다음

내장된 문서

언어 선택

이 페이지의 내용

컬렉션에서 모든 문서 선택
동등성 조건 지정
쿼리 연산자를 사용하여 조건 지정
AND 조건 지정
OR 조건 지정
AND 및 OR 조건 지정
MongoDB Atlas로 문서 쿼리
추가 쿼리 튜토리얼
행동
추가 메서드 및 옵션