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>")을 사용합니다.

연산자를 사용한 쿼리

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

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