AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

문서 읽기

MongoDB에서 읽기 작업은 데이터베이스를 쿼리하는 것으로 구성됩니다. 이 페이지에서는 예시를 제공합니다.

다음 방법을 사용하여 MongoDB 에서 문서를 쿼리 할 수 있습니다.


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


이 페이지는 mongosh에서 db.collection.find() 메서드를 사용해 쿼리 작업을 실행하는 예시를 설명합니다.

이 페이지의 예시는 sample_mflix 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우, 이 페이지의 예시를 실행하려면 데이터베이스를 제거하고 다시 생성해야 할 수 있습니다.

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

db.movies.find( {} )

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

SELECT * FROM movies

자세한 내용은 find()를 참조하세요.

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

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

다음 예시 에서는 rated 이 "PG-13"와 같은 sample_mflix.movies 컬렉션 에서 모든 문서를 선택합니다.

db.movies.find( { rated: "PG-13" } )

이 작업은 다음 SQL 문에 해당하는 쿼리 조건자 { rated: "PG-13" }를 사용합니다.

SELECT * FROM movies WHERE rated = "PG-13"

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

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

다음 예시에서는 sample_mflix.movies 컬렉션에서 rated가 "G"나 "PG-13"와 동일한 모든 문서를 조회합니다.

db.movies.find( { rated: { $in: [ "G", "PG-13" ] } } )

참고

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

작업은 다음 SQL 문에 해당하는 쿼리 조건자 { rated: { $in: [ "G", "PG-13" ] } }를 사용합니다.

SELECT * FROM movies WHERE rated in ("G", "PG-13")

MongoDB 쿼리 연산자의 전체 목록은 쿼리 조건자를 참조하세요.

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

다음 예시에서는 컬렉션에서 가 sample_mflix.movies 와 rated 같고 "G" runtime 가 () 보다$lt 작은 문서를 모두 90 조회합니다.

db.movies.find( { rated: "G", runtime: { $lt: 90 } } )

작업은 다음 SQL 문에 해당하는 쿼리 조건자 { rated: "G", runtime: { $lt: 90 } }를 사용합니다.

SELECT * FROM movies WHERE rated = "G" AND runtime < 90

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

$or 연산자 사용하여 각 절을 논리적 OR 접속사로 결합하는 복합 쿼리 지정할 수 있습니다. 이 쿼리 하나 이상의 조건과 일치하는 문서를 선택합니다.

다음 예시 sample_mflix.movies rated "G" runtime $lt 90에서는 가 와 같거나 가 ( ) 보다 작은 컬렉션 에서 모든 문서를 조회합니다.

db.movies.find( { $or: [ { rated: "G" }, { runtime: { $lt: 90 } } ] } )

작업은 다음 SQL 문에 해당하는 쿼리 조건자 { $or: [ { rated: 'G' }, { runtime: { $lt: 90 } } ] }를 사용합니다.

SELECT * FROM movies WHERE rated = "G" OR runtime < 90

참고

비교 연산자가 있는 쿼리에는 쿼리 조건자의 유형 괄호가 적용됩니다.

다음 예시 에서 복합 쿼리 문서 sample_mflix.movies 가 rated "G" 와 같고 가 runtime ( )$lt 보다 90 작거나 또는 title 이 문자로 시작하는 컬렉션 의 모든 문서를 T 선택합니다.:

db.movies.find( { rated: "G", $or: [ { runtime: { $lt: 90 } }, { title: /^T/ } ]} )

이 작업은 다음과 같은 쿼리 조건자를 사용합니다.

{ rated: 'G', $or: [ { runtime: { $lt: 90 } }, { title: { $regex: '^T' } } ]}

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

SELECT * FROM movies WHERE rated = "G"AND ( runtime < 90 OR title LIKE "T%")

참고

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

정규 표현식 구문은 mongosh 와 드라이버 간에서 다릅니다. mongosh 은 JavaScript 정규 표현식 리터럴(예시: { title: /^T/ })을 사용합니다. 드라이버는 동등한 $regex 연산자(예시: { title: { $regex: '^T' } })를 사용합니다.

이 예시 샘플 영화 데이터 세트를 사용합니다. 샘플 데이터 세트를 MongoDB Atlas 배포서버 서버에 로드하려면 샘플 데이터 로드를 참조하세요.

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

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.

    Clusters(클러스터) 페이지가 표시됩니다.

2
  1. 샘플 데이터가 포함된 클러스터의 경우 Browse Collections 을 클릭합니다.

  2. 왼쪽 탐색 창에서 sample_mflix 데이터베이스를 선택합니다.

  3. movies 컬렉션을 선택합니다.

3

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

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

{ year: 1924 }
4

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

더 많은 쿼리 예시는 다음을 참조하세요.

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

커서 문서를 반환할 때 읽기 고려 (read concern) 수준에 따라 다른 작업이 배경 에서 실행 결과에 영향을 미칠 수 있습니다. 자세한 내용은 격리, 일관성 및 최신성 읽기를 참조하세요.

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

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

커서에서 문서를 반복하는 방법을 학습하려면 드라이버 설명서를 참조하세요. mongosh를 사용하는 경우 mongosh에서 커서 반복하기를 참조하세요.

다음을 사용하여 컬렉션 에서 문서를 읽을 수도 있습니다.

참고

db.collection.findOne() 메서드는 제한이 1인 db.collection.find() 와 동일한 작업을 수행합니다.