/ /

Retrieve Data

개요

이 가이드에서는 MongoDB .NET/C# 드라이버를 사용하여 읽기 작업을 통해 MongoDB 컬렉션에서 데이터를 검색하는 방법을 배울 수 있습니다. Find() 메서드를 호출하여 기준의 설정과 일치하는 문서를 검색할 수 있습니다.

팁

인터랙티브 랩

이 페이지에는 Find() 메서드를 사용하여 데이터를 조회하는 방법을 보여주는 짧은 인터랙티브 실습이 포함되어 있습니다. MongoDB 또는 코드 편집기를 설치하지 않고도 브라우저 창에서 직접 이 실습을 완료할 수 있습니다.

실습을 시작하려면 페이지 상단에 있는 Open Interactive Tutorial 버튼을 클릭하세요. 실습을 전체 화면 형식으로 확장하려면 랩 창의 오른쪽 상단 모서리에 있는 전체 화면 버튼(⛶)을 클릭합니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants.restaurants 컬렉션 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 .NET/ C# 드라이버 시작하기를 참조하세요.

이 페이지의 예시에서는 다음 Restaurant, Address 및 GradeEntry 클래스를 모델로 사용합니다:

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    public string RestaurantId { get; set; }
    public string Cuisine { get; set; }
    public Address Address { get; set; }
    public string Borough { get; set; }
    public List<GradeEntry> Grades { get; set; }
}

public class Address
{
    public string Building { get; set; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    public string ZipCode { get; set; }
}

public class GradeEntry
{
    public DateTime Date { get; set; }
    public string Grade { get; set; }
    public float? Score { get; set; }
}

참고

restaurants 컬렉션 의 문서는 대소문자 명명 규칙을 사용합니다. 이 가이드 의 예제에서는 ConventionPack 를 사용하여 컬렉션 의 필드를 파스칼식 대/소문자로 역직렬화하고 Restaurant 클래스의 속성에 매핑합니다.

사용자 지정 직렬화에 대해 자세히 알아보려면 사용자 지정 직렬화를참조하세요.

문서 찾기

컬렉션에서 문서를 검색하려면 Find() 메서드를 사용합니다. Find() 메서드는 쿼리 필터를 사용하여 일치하는 모든 문서를 반환합니다. 쿼리 필터는 쿼리에서 검색하려는 문서를 지정하는 객체입니다.

쿼리 필터에 대해 자세히 학습 쿼리 필터 만들기를 참조하세요.

하나의 문서 찾기

컬렉션에서 단일 문서를 찾으려면 찾으려는 문서의 기준을 지정하는 쿼리 필터를 전달한 다음 FirstOrDefault() 또는 FirstOrDefaultAsync() 메서드를 체인으로 연결합니다. 쿼리 필터와 일치하는 문서가 두 개 이상인 경우, 이 메서드는 조회된 결과에서 처음 일치하는 문서를 반환합니다. 쿼리 필터와 일치하는 문서가 없는 경우 메서드는 null을 반환합니다.

var restaurants = _restaurantsCollection.Find(filter).FirstOrDefault();

var restaurants = await _restaurantsCollection.Find(filter).FirstOrDefaultAsync();

팁

첫 번째 문서

정렬 기준이 지정되지 않은 경우 FirstOrDefault() 메서드는 디스크에 기본 순서에 따라 첫 번째 문서를 반환합니다.

Find() 메서드를 사용하여 단일 문서를 찾는 예시 전체를 보려면 추가 정보를 참조하세요.

여러 문서 찾기

컬렉션에서 여러 문서를 찾으려면 검색하려는 문서의 기준을 지정하는 Find() 메서드에 쿼리 필터를 전달합니다.

커서를 사용하여 Find() 메서드에서 반환한 문서를 반복할 수 있습니다. 커서는 애플리케이션이 주어진 시간에 데이터베이스 결과의 하위 집합만 메모리에 유지하면서 데이터베이스 결과를 반복할 수 있는 메커니즘입니다. 커서는 Find() 메소드가 많은 양의 문서를 반환할 때 유용합니다.

커서를 사용하여 문서를 반복하려면 찾으려는 문서의 기준을 지정하는 Find() 메서드에 쿼리 필터를 전달한 다음 ToCursor() 또는 ToCursorAsync() 메서드를 연결합니다. 동기 또는 비동기 예시를 보려면 해당 탭을 선택합니다.

var restaurants = _restaurantsCollection.Find(filter).ToCursor();

var restaurants = await _restaurantsCollection.Find(filter).ToCursorAsync();

적은 수의 문서를 반환하거나 결과를 List 객체로 반환해야 하는 경우 ToList() 또는 ToListAsync() 메서드를 사용합니다.

컬렉션에서 여러 문서를 찾아 메모리에 목록으로 보관하려면 찾으려는 문서의 기준을 지정하는 Find() 메서드에 쿼리 필터를 전달한 다음 ToList() 또는 ToListAsync() 메서드를 연결합니다. 동기 또는 비동기 예시를 보려면 해당 탭을 선택합니다.

var restaurants = _restaurantsCollection.Find(filter).ToList();

var restaurants = await _restaurantsCollection.Find(filter).ToListAsync();

Find() 메서드를 사용하여 여러 문서를 찾는 전체 예시를 보려면 추가 정보를 참조하세요.

참고

모든 문서 찾기

컬렉션의 모든 문서를 찾으려면 Find() 메서드에 빈 필터를 전달합니다.

var filter = Builders<Restaurant>.Filter.Empty;
var allRestaurants = _restaurantsCollection.Find(filter);

Find() 메서드를 사용하여 모든 문서를 찾는 실행 가능한 예시 전체를 보려면 추가 정보를 참조하세요.

검색 동작 수정

FindOptions 객체를 전달하여 Find() 메서드의 동작을 수정할 수 있습니다.

다음 메서드를 통해 일반적으로 사용되는 옵션을 구성할 수 있습니다

메서드	설명
`BatchSize`	쿼리 결과에서 반환되는 각 배치 내 최대 문서 수를 가져오거나 설정합니다. `batchSize` 을 설정하다 하지 않으면 `Find()` 메서드의 초기 배치 크기는 `101` 문서이고, 각 후속 배치 의 최대 크기는 16 메비바이트(MiB)입니다. 이 옵션은 16 MiB보다 작은 제한을 시행하다 할 수 있지만 더 큰 제한은 적용할 수 없습니다. 배치가 16 MiB보다 커지는 제한으로 `batchSize` 를 설정하다 경우 이 옵션은 효과가 없으며 `Find()` 메서드는 기본값 배치 크기를 사용합니다.
`Collation`	데이터 정렬 옵션을 설정합니다. 자세한 내용은 이 페이지의 데이터 정렬 섹션을 참조하세요.
`Comment`	프로파일러 로그를 더 쉽게 찾을 수 있도록 쿼리 에 주석을 설정합니다.
`Hint`	사용할 인덱스에 대한 힌트를 설정합니다.
`MaxTime`	이 작업에 대한 서버의 최대 실행 시간을 설정합니다.

사용 가능한 옵션의 전체 목록을 보려면 FindOptions 속성을 참조하세요.

데이터 정렬

작업에 대한 데이터 정렬을 구성하려면 데이터 정렬 클래스의 인스턴스를 만듭니다.

다음 표에서는 Collation 생성자가 허용하는 매개변수에 대해 설명합니다. 또한 각 설정의 값을 읽는 데 사용할 수 있는 해당 클래스 속성 도 나열되어 있습니다.

Parameter	설명	클래스 속성
`locale`	유니코드용 국제 구성 요소(ICU) 국가 및 언어 설정 및 언어 설정을 지정합니다. 지원되는 국가 및 언어 설정 목록은 MongoDB Server `Collation.Simple` `Collation` `locale` `"simple"`매뉴얼의 데이터 정렬 국가 및 언어 설정 및 기본 매개변수를 참조하세요. 단순 이진 비교를 사용하려면 정적 속성 사용하여 가 로 설정하다 객체 반환합니다. 데이터 유형: `string`	`Locale`
`caseLevel`	(선택 사항) 대소문자 비교를 포함할지 여부를 지정합니다. 이 인수가 인 경우 `true` 드라이버의 동작은 인수의 값에 따라 달라집니다.`strength` - 가 인 경우 `strength` `CollationStrength.Primary`운전자 기본 문자와 대소문자를 비교합니다. - 가 `strength` `CollationStrength.Secondary`인 경우 운전자 기본 문자, 분음 부호, 기타 세컨더리 차이점 및 대소문자를 비교합니다. - `strength` 이 다른 값인 경우 이 인수는 무시됩니다. 이 인수가 인 `false` 경우 운전자 강도 수준 `Primary` 또는 에서 대소문자 비교를 포함하지 `Secondary` 않습니다. 데이터 유형: `boolean` 기본값: `false`	`CaseLevel`
`caseFirst`	(선택 사항) 3차 수준 비교 시 대소문자 차이의 정렬 순서를 지정합니다. 데이터 유형: CollationCaseFirst 기본값: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(선택 사항) ICU 문서에 정의된 대로 수행할 비교 수준을 지정합니다. 데이터 유형: CollationStrength 기본값: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(선택 사항) 운전자 숫자 문자열을 숫자로 비교할지 여부를 지정합니다. 이 인수가 `true` 이면 운전자 숫자 문자열을 숫자로 비교합니다. 예시 를 들어 "10문자열과 "2" 문자열을 비교할 때 운전자 값을 10 및 로 2 처리하고 가 10 더 큰 것을 찾습니다. 이 인수가 `false` 이거나 제외되면 운전자 숫자 문자열을 문자열로 비교합니다. 예시 를 들어10문자열과 '2' 문자열을 비교할 때 운전자 한 번에 한 문자씩 비교합니다. '1'는 ' '보다 작으므로2운전자 '10'이 ' '보다 작은 것을2찾습니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 제한을 참조하세요. 데이터 유형: `boolean` 기본값: `false`	`NumericOrdering`
`alternate`	(선택 사항) 운전자 비교를 위해 공백과 문장 부호를 기본 문자로 간주할지 여부를 지정합니다. 데이터 유형: CollationAlternate 기본값:(공백과 `CollationAlternate.NonIgnorable` 문장 부호는 기본 문자로 간주됨)	`Alternate`
`maxVariable`	(선택 사항) 인수가 일 때 운전자 무시할 수 있는 것으로 간주하는 `alternate` `CollationAlternate.Shifted`문자를 지정합니다. 데이터 유형: CollationMaxVariable 기본값:( `CollationMaxVariable.Punctuation` 운전자 구두점 및 공백 무시)	`MaxVariable`
`normalization`	(선택 사항) 운전자 필요에 따라 텍스트를 정규화할지 여부를 지정합니다. 대부분의 텍스트에는 정규화가 필요하지 않습니다. 정규화에 대한 자세한 내용은 ICU 문서를 참조하세요. 데이터 유형: 기본값: `boolean` `false`	`Normalization`
`backwards`	(선택 사항) 분음 부호가 포함된 문자열을 문자열 뒤쪽에서 앞쪽으로 정렬할지 여부를 지정합니다. 데이터 유형: `boolean` 기본값: `false`	`Backwards`

데이터 정렬에 대한 자세한 내용은 MongoDB Server 매뉴얼의 데이터 정렬 페이지를 참조하세요.

예시

이 예에서는 다음 조치를 수행합니다.

cuisine 필드에 'Pizza'가 포함된 모든 문서를 찾습니다.
.BatchSize를 3으로 설정
결과를 커서에 저장
커서가 참고한 문서를 인쇄합니다.

var filter = Builders<Restaurant>.Filter.Eq("cuisine", "Pizza");
var findOptions = new FindOptions { BatchSize = 3 };
using (var cursor = _restaurantsCollection.Find(filter, findOptions).ToCursor())
{
   foreach (var r in cursor.ToEnumerable())
   {
      WriteLine(r.Name);
   }
}

Pizza Town
Victoria Pizza
...

팁

정리

커서 더 이상 사용되지 않을 때 자동으로 Dispose() 메서드를 호출하는 using 성명서 사용하여 커서 만듭니다.

추가 정보

쿼리 필터에 대해 자세히 학습 쿼리 필터 만들기를 참조하세요.

LINQ를 사용하여 쿼리를 지정하는 방법을 학습 애그리게이션 작업을 위한 LINQ 구문 참조하세요.

찾기 작업의 실행 가능한 예는 다음과 같은 사용의 예를 참조하세요.

API 문서

이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

쿼리 지정

반환할 문서 지정