db.collection.find()

인터랙티브 튜토리얼 열기

임베디드 필드 지정

포함된 문서의 필드에 대해서는 다음 둘 중 하나를 사용하여 필드를 지정할 수 있습니다.

• 점 표기법(예: "field.nestedfield": <value>

• 중첩된 양식(예: { field: { nestedfield: <value> } }

_id 필드 프로젝션

필드를 표시하지 않기 위해 프로젝션에서 _id: 0을 명시적으로 지정하지 않는 한 _id 필드는 기본적으로 반환된 문서에 포함됩니다.

포함 또는 제외

projection 필드는 포함과 제외 사양을 모두 포함할 수 없습니다. 단, _id 필드는 예외입니다.

• 필드를 명시적으로 포함하는 프로젝션에서 _id 필드는 명시적으로 제외할 수 있는 유일한 필드입니다.

• 필드를 명시적으로 제외하는 프로젝션에서는 _id 필드가 명시적으로 포함할 수 있는 유일한 필드이지만, _id 필드는 기본적으로 포함됩니다.

프로젝션 예제를 참조하세요.

세션 유휴 시간 초과

MongoDB 드라이버와 mongosh 는 승인되지 않은 쓰기 작업을 제외한 모든 작업을 서버 세션 과 연결합니다. 세션과 명시적으로 연결되지 않은 작업(예: Mongo.startSession() 사용)의 경우, MongoDB 드라이버와 mongosh 는 암시적 세션을 생성하여 작업과 연결합니다.

세션이 30분 이상 유휴 상태인 경우, MongoDB 서버는 해당 세션을 만료된 것으로 표시하고 언제든지 세션을 종료할 수 있습니다. MongoDB 서버가 세션을 종료하면 진행 중인 모든 작업과 해당 세션과 관련된 열린 커서도 종료됩니다. 여기에는 noCursorTimeout() 또는 30분보다 큰 maxTimeMS()로 구성된 커서가 포함됩니다.

30분 이상 유휴 상태일 수 있는 작업의 경우 Mongo.startSession()을 사용하여 작업을 명시적 세션과 연결하고 refreshSessions 명령을 사용하여 세션을 정기적으로 새로 고침합니다. 자세한 내용은 세션 유휴 시간 제한을 참조하세요.

동등에 대한 쿼리

• 다음 연산은 _id가 5인 bios 컬렉션의 문서를 반환합니다.

  db.bios.find( { _id: 5 } )

• 다음 작업은 name 포함된 문서의 last 필드가 "Hopper"와 동일한 bios collection의 문서를 반환합니다:

  db.bios.find( { "name.last": "Hopper" } )

  참고

  포함된 문서의 필드에 액세스하려면 점 표기법("<embedded document>.<field>")을 사용합니다.

연산자를 사용한 쿼리

선택 기준 세트와 일치하는 문서를 찾으려면 <criteria> 매개 변수와 함께 find() 를 호출합니다.

MongoDB는 기준을 지정하는 다양한 쿼리 연산자를 제공합니다.

• 다음 연산은 $in 연산자를 사용하여 _id가 5 또는 ObjectId("507c35dd8fada716c89d0013")인 bios 컬렉션의 문서를 반환합니다.

  db.bios.find(
     { _id: { $in: [ 5, ObjectId("507c35dd8fada716c89d0013") ] } }
  )

• 다음 작업은 $gt 연산자를 사용하여 birth가 new Date('1950-01-01')보다 큰 bios 컬렉션의 모든 문서를 반환합니다.

  db.bios.find( { birth: { $gt: new Date('1950-01-01') } } )

• 다음 작업은 $regex 연산자를 사용하여 bios 컬렉션에서 name.last 필드가 문자 N(또는 "LIKE N%")으로 시작하는 문서를 반환합니다.

  db.bios.find(
     { "name.last": { $regex: /^N/ } }
  )

쿼리 연산자 목록은 쿼리 선택기를 참조하세요.

범위 쿼리

비교 연산자를 결합하여 필드에 대한 범위를 지정합니다. 다음 작업은 birth가 new Date('1940-01-01')에서 new Date('1960-01-01')(제외) 사이인 bios collection 문서에서 반환합니다.

db.bios.find( { birth: { $gt: new Date('1940-01-01'), $lt: new Date('1960-01-01') } } )

쿼리 연산자 목록은 쿼리 선택기를 참조하세요.

여러 조건에 대한 쿼리

다음 작업은 birth 필드가 greater than new Date('1950-01-01')이고 death 필드가 존재하지 않는 bios collection의 모든 문서를 반환합니다.

db.bios.find( {
   birth: { $gt: new Date('1920-01-01') },
   death: { $exists: false }
} )

쿼리 연산자 목록은 쿼리 선택기를 참조하세요.

포함된 문서에서 정확히 일치하는 항목 쿼리하기

다음 작업은 순서를 포함하여 포함된 문서 name이 정확히 { first: "Yukihiro", last: "Matsumoto" }인 bios collection의 문서를 반환합니다.

db.bios.find(
    { name: { first: "Yukihiro", last: "Matsumoto" } }
)

name 필드는 포함된 문서와 정확히 일치해야 합니다. 쿼리는 다음 name 필드가 있는 문서와 일치하지 않습니다.

{
   first: "Yukihiro",
   aka: "Matz",
   last: "Matsumoto"
}
{
   last: "Matsumoto",
   first: "Yukihiro"
}

포함된 문서의 쿼리 필드

다음 작업은 포함된 문서 name에 "Yukihiro" 값이 포함된 first 필드 및 "Matsumoto" 값이 포함된 last 필드가 포함된 bios collection의 문서를 반환합니다. 이 쿼리는 점 표기법을 사용하여 포함된 문서의 필드에 액세스합니다.

db.bios.find(
   {
     "name.first": "Yukihiro",
     "name.last": "Matsumoto"
   }
)

쿼리는 name 필드에 값이 "Yukihiro"인 first 필드와 값이 "Matsumoto"인 last 필드가 있는 포함된 문서를 가진 문서와 일치합니다. 예를 들어 쿼리는 다음 값 중 하나를 포함하는 name 필드가 있는 문서와 일치합니다.

{
  first: "Yukihiro",
  aka: "Matz",
  last: "Matsumoto"
}
{
  last: "Matsumoto",
  first: "Yukihiro"
}

자세한 내용 및 예시는 포함/중첩 문서에 대한 쿼리를 참조하세요.

배열 요소에 대한 쿼리

다음 예제에서는 bios 컬렉션의 contribs 배열을 쿼리합니다.

• 다음 연산은 배열 필드 contribs에 "UNIX"가 포함된 bios 컬렉션의 문서를 반환합니다.

  db.bios.find( { contribs: "UNIX" } )

• 다음 연산은 배열 필드 contribs에 "ALGOL" 또는 "Lisp" 요소가 포함된 bios 컬렉션의 문서를 반환합니다.

  db.bios.find( { contribs: { $in: [ "ALGOL", "Lisp" ]} } )

• 다음 작업은 $all 쿼리 연산자를 사용하여 배열 필드 contribs에 요소 "ALGOL"과 "Lisp"가 모두 포함된 bios collection의 문서를 반환합니다.

  db.bios.find( { contribs: { $all: [ "ALGOL", "Lisp" ] } } )

  더 많은 예시를 보려면 $all을 참조하세요. $elemMatch도 함께 참조해도 좋습니다.

• 다음 연산은 $size 연산자를 사용하여 배열 크기 contribs가 4인 bios 컬렉션의 문서를 반환합니다.

  db.bios.find( { contribs: { $size: 4 } } )

배열 쿼리에 대한 자세한 내용과 예제는 다음을 참조하세요.

• 배열 쿼리

• 임베디드 문서 배열 쿼리하기

배열별 쿼리 연산자 목록은 배열을 참조하세요.

문서 배열 쿼리하기

다음 예제에서는 bios 컬렉션의 awards 배열을 쿼리합니다.

• 다음 연산은 awards 배열에 award 필드가 "Turing Award"인 요소가 포함된 bios 컬렉션의 문서를 반환합니다.

  db.bios.find(
     { "awards.award": "Turing Award" }
  )

• 다음 작업은 bios collection에 있는 문서 중 awards 배열에 award 필드가 모두 "Turing Award"이고 year 필드가 1980보다 큰 요소가 하나 이상 포함된 문서를 반환합니다.

  db.bios.find(
     { awards: { $elemMatch: { award: "Turing Award", year: { $gt: 1980 } } } }
  )

  $elemMatch 연산자를 사용하여 배열 요소에 여러 기준을 지정할 수 있습니다.

배열 쿼리에 대한 자세한 내용과 예제는 다음을 참조하세요.

• 배열 쿼리

• 임베디드 문서 배열 쿼리하기

배열별 쿼리 연산자 목록은 배열을 참조하세요.

반환할 필드 지정

다음 연산은 bios 컬렉션에서 모든 문서를 찾아 name 필드, contribs 필드 및 _id 필드만 반환합니다.

db.bios.find( { }, { name: 1, contribs: 1 } )

명시적으로 제외된 필드

다음 연산은 bios 컬렉션을 쿼리하여 name 포함된 문서의 first 필드와 birth 필드를 제외한 모든 필드를 반환합니다.

db.bios.find(
   { contribs: 'OOP' },
   { 'name.first': 0, birth: 0 }
)

_id 필드를 명시적으로 제외

다음 연산은 bios 컬렉션에서 문서를 찾아 name 필드와 contribs 필드만 반환합니다.

db.bios.find(
   { },
   { name: 1, contribs: 1, _id: 0 }
)

배열 및 포함된 문서에서

다음 연산은 bios 컬렉션을 쿼리하여 name 포함된 문서의 last 필드와 contribs 배열의 처음 두 요소를 반환합니다.

db.bios.find(
   { },
   { _id: 0, 'name.last': 1, contribs: { $slice: 2 } } )

중첩된 양식을 사용하여 포함된 필드를 지정할 수도 있습니다. 예를 들면 다음과 같습니다.

db.bios.find(
   { },
   { _id: 0, name: { last: 1 }, contribs: { $slice: 2 } }
)

애그리게이션 표현식 사용

db.collection.find() 프로젝션은 애그리게이션 표현식 및 구문을 허용할 수 있습니다.

애그리게이션 표현식과 구문을 사용하여 새 필드를 프로젝션하거나 기존 필드를 새 값으로 프로젝션할 수 있습니다. 예를 들어 다음 작업에서는 애그리게이션 표현식을 사용하여 name 및 awards 필드의 값을 재정의하고, 새 필드 reportDate, reportBy, reportNumber를 포함합니다.

db.bios.find(
   { },
   {
     _id: 0,
     name: {
        $concat: [
           { $ifNull: [ "$name.aka", "$name.first" ] },
           " ",
           "$name.last"
        ]
     },
     birth: 1,
     contribs: 1,
     awards: { $cond: { if: { $isArray: "$awards" }, then: { $size: "$awards" }, else: 0 } },
     reportDate: { $dateToString: {  date: new Date(), format: "%Y-%m-%d" } },
     reportBy: "hellouser123",
     reportNumber: { $literal: 1 }
   }
)

reportRun 필드를 reportRun 값으로 설정하면 작업이 다음 문서를 반환합니다.

{ "birth" : ISODate("1924-12-03T05:00:00Z"), "contribs" : [ "Fortran", "ALGOL", "Backus-Naur Form", "FP" ], "name" : "John Backus", "awards" : 4, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1927-09-04T04:00:00Z"), "contribs" : [ "Lisp", "Artificial Intelligence", "ALGOL" ], "name" : "John McCarthy", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1906-12-09T05:00:00Z"), "contribs" : [ "UNIVAC", "compiler", "FLOW-MATIC", "COBOL" ], "name" : "Grace Hopper", "awards" : 4, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1926-08-27T04:00:00Z"), "contribs" : [ "OOP", "Simula" ], "name" : "Kristen Nygaard", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1931-10-12T04:00:00Z"), "contribs" : [ "OOP", "Simula" ], "name" : "Ole-Johan Dahl", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1956-01-31T05:00:00Z"), "contribs" : [ "Python" ], "name" : "Guido van Rossum", "awards" : 2, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1941-09-09T04:00:00Z"), "contribs" : [ "UNIX", "C" ], "name" : "Dennis Ritchie", "awards" : 3, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1965-04-14T04:00:00Z"), "contribs" : [ "Ruby" ], "name" : "Matz Matsumoto", "awards" : 1, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "birth" : ISODate("1955-05-19T04:00:00Z"), "contribs" : [ "Java" ], "name" : "James Gosling", "awards" : 2, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }
{ "contribs" : [ "Scala" ], "name" : "Martin Odersky", "awards" : 0, "reportDate" : "2020-06-05", "reportBy" : "hellouser123", "reportNumber" : 1 }

변수 이름 사용

다음 예제에서는 변수 myCursor를 사용하여 커서를 반복하고 일치하는 문서를 인쇄합니다.

var myCursor = db.bios.find( );
myCursor

next() 메서드 사용

다음 예시에서는 커서 메서드 next()를 사용하여 문서에 액세스합니다.

var myCursor = db.bios.find( );
var myDocument = myCursor.hasNext() ? myCursor.next() : null;
if (myDocument) {
    var myName = myDocument.name;
    print (tojson(myName));
}

인쇄하려면 print(tojson()) 대신 printjson() 메서드를 사용할 수도 있습니다.

if (myDocument) {
   var myName = myDocument.name;
   printjson(myName);
}

forEach() 메서드 사용

다음 예제에서는 커서 메서드 forEach()를 사용하여 커서를 반복하고 문서에 액세스합니다.

var myCursor = db.bios.find( );
myCursor.forEach(printjson);

결과 세트의 문서 순서

sort() 메서드는 결과 설정의 문서를 정렬합니다. 다음 작업은 bios collection 문서를 name 필드를 기준으로 오름차순으로 정렬하여 반환합니다:

db.bios.find().sort( { name: 1 } )

sort()는 SQL에서 ORDER BY 문에 해당합니다.

반환할 문서 수 제한하기

limit() 메서드는 결과 세트의 문서 수를 제한합니다. 다음 작업은 bios collection에서 최대 5개의 문서를 반환합니다.

db.bios.find().limit( 5 )

limit()는 SQL에서 LIMIT 문에 해당합니다.

결과 집합의 시작점 설정

skip() 메서드는 결과 세트의 시작점을 제어합니다. 다음 작업은 bios collection의 처음 5개의 문서를 건너뛰고 나머지 모든 문서를 반환합니다.

db.bios.find().skip( 5 )

데이터 정렬 지정

데이터 정렬을 사용하면 대소문자 및 악센트 표시 규칙과 같은 문자열 비교에 대한 언어별 규칙을 지정할 수 있습니다.

collation() 메서드는 작업에 대한 데이터 db.collection.find() 정렬 을 지정합니다.

db.bios.find( { "name.last": "hopper" } ).collation( { locale: "en_US", strength: 1 } )

커서 메서드 결합

다음 성명서는 커서 메서드 limit()와 sort()를 연결합니다.

db.bios.find().sort( { name: 1 } ).limit( 5 )
db.bios.find().limit( 5 ).sort( { name: 1 } )

두 성명서는 동일합니다. 즉, limit() 및 sort() 메서드를 연결하는 순서는 중요하지 않습니다. 두 성명서 모두 '이름'의 오름차순 정렬 순서에 따라 처음 5개의 문서를 반환합니다.

사용 가능한 mongosh 커서 메서드

옵션으로 제한

다음 쿼리는 limit 옵션 매개변수를 사용하여 결과 세트의 문서 수를 제한합니다.

db.users.find(
   { username : "rajiv"}, // query
   { age : 1 }, // projection
   { limit : 1 } // options
)

allowDisk옵션과 함께 사용

다음 쿼리는 options 매개 변수를 사용하여 allowDiskUse 을 활성화합니다.

db.users.find(
   { username : "david" },
   { age : 1 },
   { allowDiskUse : true }
)

옵션으로 설명

다음 쿼리는 options 매개변수를 사용하여 executionStats 설명 출력을 가져옵니다.

var cursor = db.users.find(
   { username: "amanda" },
   { age : 1 },
   { explain : "executionStats" }
)
cursor.next()

쿼리에 여러 옵션 지정

다음 쿼리는 options 단일 쿼리에 여러 를 사용합니다. 이 쿼리는 limit 로 설정된 를 사용하여 2 두 개의 문서만 반환하고,showRecordId 로 설정된 true 을 사용하여 결과 집합에서 문서의 위치를 반환합니다.

db.users.find(
   {},
   { username: 1, age: 1 },
   {
     limit: 2,
     showRecordId: true
   }
)