반환된 결과 건너뛰기

개요

이 가이드 에서는 MongoDB Rust 드라이버 를 사용하여 결과를 반환할 때 지정된 수의 문서를 건너뛰는 읽기 작업을 수행하는 방법을 학습 수 있습니다.

예시용 샘플 데이터

이 가이드의 예시에서는 다음 Book 구조체를 books collection의 문서 모델로 사용합니다.

#[derive(Debug, Serialize, Deserialize)]
struct Book {
    name: String,
    author: String,
    length: i32,
}

다음 코드는 books 컬렉션 에 샘플 데이터를 삽입하는 방법을 보여줍니다.

let uri = "connection string";
let client = Client::with_uri_str(uri).await?;
let my_coll: Collection<Book> = client.database("db").collection("books");
let books = vec![
    Book {
        id: 1,
        name: "The Brothers Karamazov".to_string(),
        author: "Dostoyevsky".to_string(),
        length: 824,
    },
    Book {
        id: 2,
        name: "Atlas Shrugged".to_string(),
        author: "Rand".to_string(),
        length: 1088,
    },
    Book {
        id: 3,
        name: "Les Misérables".to_string(),
        author: "Hugo".to_string(),
        length: 1462,
    },
    Book {
        id: 4,
        name: "A Dance with Dragons".to_string(),
        author: "Martin".to_string(),
        length: 1104,
    },
];
my_coll.insert_many(books).await?;

문서 건너뛰기

쿼리 로 검색된 결과를 건너뛰거나 집계 파이프라인 내의 결과를 건너뛸 수 있습니다.

이 섹션에서는 다음과 같은 방법으로 결과를 건너뛰는 방법을 설명합니다.

skip() 메서드:skip() 메서드를 메서드에 연결합니다.find()
FindOptions 구조체:skip() 옵션 빌더 메서드를 사용하여 FindOptions 구조체를 구성합니다.
집계 파이프라인: 단계를 사용하는 파이프라인 을 만듭니다.$skip

건너뛴 문서의 수가 쿼리 와 일치하는 문서 수를 초과하는 경우 해당 쿼리 는 문서를 반환하지 않습니다.

찾기 작업은 어떤 필드에서도 정렬되지 않은 기본 순서 로 문서를 반환합니다. 임의의 문서를 건너뛰는 것을 방지하려면 건너뛰기 옵션을 설정하기 전에 sort() 메서드를 사용하여 고유 값이 있는 필드 에서 문서를 정렬합니다. 학습 보려면 결과 정렬 가이드 를 참조하세요.

skip() 메서드 예제

문서를 건너뛰려면 skip() 메서드를 find() 메서드에 연결할 수 있습니다. skip() 메서드는 결과 설정하다 의 시작 부분에서 생략할 문서 수를 지정하는 정수를 사용합니다.

이 예시 에서는 다음 조치를 수행하는 find() 작업을 실행합니다.

결과를 author 필드 값의 오름차순으로 정렬합니다.
처음 두 문서를 건너뜁니다.
나머지 문서를 반환합니다.

let mut cursor = my_coll
    .find(doc! {})
    .sort(doc! { "author": 1 })
    .skip(2).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
}

Book { name: "A Dance with Dragons", author: "Martin", length: 1104 }
Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }

옵션 예시

또는 쿼리 에 대한 옵션을 설정하고 재사용하는 경우 FindOptions 사용할 수 있습니다. skip() 옵션 빌더 메서드를 사용하여 FindOptions 구조체의 skip 필드 를 설정합니다. 그런 다음 with_options() 메서드를 find() 메서드에 연결하고 FindOptions 구조체를 with_options() 메서드에 매개 변수로 전달합니다.

이 예시 에서는 다음 조치를 수행하는 find() 작업을 실행합니다.

결과를 name 필드 값의 내림차순으로 정렬합니다.
첫 번째 문서 건너뛰기
나머지 문서를 반환합니다.

let find_options = FindOptions::builder()
    .sort(doc! { "name": -1 })
    .skip(1)
    .build();
let mut cursor = my_coll.find(doc! {}).with_options(find_options).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
}

Book { name: "Les Misérables", author: "Hugo", length: 1462 }
Book { name: "Atlas Shrugged", author: "Rand", length: 1088 }

집계 예시

집계 파이프라인 의 $skip 단계를 사용하여 문서를 건너뛸 수 있습니다. 집계 작업에 학습 보려면 애그리게이션 가이드 를 참조하세요.

이 예시 에서는 다음 작업을 수행하는 집계 파이프라인 을 실행합니다.

결과를 author 필드 값의 오름차순으로 정렬합니다.
첫 번째 문서 건너뛰기
나머지 문서를 반환합니다.

let pipeline = vec![
    doc! { "$match": {} },
    doc! { "$sort": { "author": 1 } },
    doc! { "$skip": 1 },
];
let mut cursor = my_coll.aggregate(pipeline).await?;
while let Some(result) = cursor.try_next().await? {
    println!("{:?}", result);
}

Document({"_id": Int32(3), "name": String("Les Misérables"), "author": String("Hugo"), "length": Int32(1462)})
Document({"_id": Int32(4), "name": String("A Dance with Dragons"), "author": String("Martin"), "length": Int32(1104)})
Document({"_id": Int32(2), "name": String("Atlas Shrugged"), "author": String("Rand"), "length": Int32(1088)})

추가 정보

이 가이드 에 언급된 작업에 학습 보려면 다음 가이드를 참조하세요.

API 문서

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

돌아가기

결과 정렬

결과 제한