반환할 문서 지정

개요

이 가이드 에서는 다음 메서드를 사용하여 읽기 작업에서 반환할 문서를 지정하는 방법을 학습 수 있습니다.

• sort(): 반환된 문서의 정렬 순서를 지정합니다.

• limit(): 쿼리에서 반환할 최대 문서 수를 지정합니다.

• skip(): 쿼리 결과를 반환하기 전에 건너뛸 문서 수를 지정합니다.

const myDB = client.db("myDB");
const myColl = myDB.collection("books");
await myColl.insertMany([
  { "_id": 1, "name": "The Brothers Karamazov", "author": "Dostoyevsky", "length": 824 },
  { "_id": 2, "name": "Les Misérables", "author": "Hugo", "length": 1462 },
  { "_id": 3, "name": "Atlas Shrugged", "author": "Rand", "length": 1088 },
  { "_id": 4, "name": "Infinite Jest", "author": "Wallace", "length": 1104 },
  { "_id": 5, "name": "Cryptonomicon", "author": "Stephenson", "length": 918 },
  { "_id": 6, "name": "A Dance With Dragons", "author": "Martin", "length": 1104 },
]);

Sort

읽기 작업에서 문서를 반환하는 순서를 변경하려면 sort() 메서드를 사용합니다. 이 메서드는 MongoDB 반환된 문서를 특정 방향의 하나 이상의 필드 값에 따라 정렬하도록 지시합니다. 반환된 문서를 필드 별로 오름차순(낮은 항목부터)으로 정렬하려면 1 값을 사용합니다. 대신 내림차순(가장 큰 것부터)으로 정렬하려면 -1를 사용합니다. 정렬을 지정하지 않으면 MongoDB 쿼리 결과의 순서를 보장하지 않습니다.

다음 예시 정렬 문서 읽기 작업으로 전달하여 작업이 길이가 긴 책을 길이가 짧은 책보다 먼저 반환하도록 합니다.

// define an empty query document
const query = {};
// sort in descending (-1) order by length
const sortFields = { length: -1 };
const cursor = myColl.find(query).sort(sortFields);
for await (const doc of cursor) {
  console.dir(doc);
}

이 경우 숫자 -1은 읽기 작업에 책을 길이에 따라 내림차순으로 정렬하도록 지시합니다. 이 정렬을 빈 쿼리와 함께 사용하면 find()는 다음과 같은 문서를 반환합니다:

{ "_id": 2, "title": "Les Misérables", "author": "Hugo", "length": 1462 }
{ "_id": 4, "title": "Infinite Jest", "author": "Wallace", "length": 1104 }
{ "_id": 6, "title": "A Dance with Dragons", "author": "Martin", "length": 1104 }
{ "_id": 3, "title": "Atlas Shrugged", "author": "Rand", "length": 1088 }
{ "_id": 5, "title": "Cryptonomicon", "author": "Stephenson", "length": 918 }
{ "_id": 1, "title": "The Brothers Karamazov", "author": "Dostoyevsky", "length": 824 }

지정된 정렬을 사용하면 두 개 이상의 문서 순서가 모호해지는 경우가 있습니다. 앞의 예시 에서 title 값이 "A Dance with Dragons" 및 "Infinite Jest" 인 문서는 모두 length 이 1104이므로 반환되는 순서는 보장되지 않습니다. 반복 가능한 방식으로 정렬된 결과의 동점을 해결하려면 정렬 문서 에 필드를 추가합니다.

// define an empty query document
const query = {};
// sort in ascending (1) order by length
const sortFields = { length: 1, author: 1 };
const cursor = myColl.find(query).sort(sortFields);
for await (const doc of cursor) {
  console.dir(doc);
}

문서 정렬에 author 필드 를 추가하면 읽기 작업은 일치하는 문서를 먼저 length 순으로 정렬한 다음, 타이가 있는 경우 author 순으로 정렬합니다. 일치하는 문서 필드는 문서 정렬에 지정된 필드와 동일한 순서로 비교됩니다. find() 는 쿼리 와 일치하는 문서에 이 정렬을 사용할 때 다음과 같은 문서 순서를 반환합니다.

{ "_id": 1, "title": "The Brothers Karamazov", "author": "Dostoyevsky", "length": 824 }
{ "_id": 5, "title": "Cryptonomicon", "author": "Stephenson", "length": 918 }
{ "_id": 3, "title": "Atlas Shrugged", "author": "Rand", "length": 1088 }
{ "_id": 6, "title": "A Dance with Dragons", "author": "Martin", "length": 1104 }
{ "_id": 4, "title": "Infinite Jest", "author": "Wallace", "length": 1104 }
{ "_id": 2, "title": "Les Misérables", "author": "Hugo", "length": 1462 }

Limit

읽기 작업에서 반환할 수 있는 문서 수를 제한하려면 limit() 메서드를 사용합니다. 이 메서드는 작업에서 반환할 수 있는 최대 문서 수를 지정하지만, 문서가 충분하지 않아 제한에 도달할 수 없는 경우 작업에서 더 적은 수의 문서를 반환할 수 있습니다. limit() 을 skip() 메서드와 함께 사용하면 건너뛰기가 먼저 적용되고 건너뛰기 후 남은 문서에만 제한이 적용됩니다.

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

• 빈 쿼리 필터하다 사용하여 컬렉션 의 모든 문서를 일치시킵니다.

• sort() 메서드를 호출하여 length 필드 기준으로 내림차순 정렬을 결과에 적용 .

• limit() 메서드를 호출하여 처음 3 개의 결과만 반환합니다.

// define an empty query document
const query = {};
// sort in descending (-1) order by length
const sortFields = { length: -1 };
const limitNum = 3;
const cursor = myColl.find(query).sort(sortFields).limit(limitNum);
for await (const doc of cursor) {
  console.dir(doc);
}

위의 코드 예시는 길이별로 정렬된 다음 세 개의 문서를 출력합니다.

{ "_id": 2, "title": "Les Misérables", "author": "Hugo", "length": 1462 }
{ "_id": 6, "title": "A Dance With Dragons", "author": "Martin", "length": 1104 }
{ "_id": 4, "title": "Infinite Jest", "author": "Wallace", "length": 1104 }

myColl.find(query).sort({ length: -1 }).limit(3);
myColl.find(query).limit(3).sort({ length: -1 });

Skip

읽기 작업 결과의 시작 부분에서 문서를 생략하려면 skip() 메서드를 사용합니다. skip() 를 sort() 와 결합하여 주어진 쿼리에 대한 상위(내림차순) 또는 하위(오름차순) 결과를 생략할 수 있습니다. 정렬이 없는 경우 반환되는 문서의 순서가 보장되지 않으므로 skip() 을(를) 사용하지 않고 을(를) 사용하면 sort() 임의의 문서가 생략됩니다.

skip() 값이 쿼리에 대해 일치하는 문서 수를 초과하는 경우 해당 쿼리는 문서를 반환하지 않습니다.

이 예시 다음 작업을 수행하여 길이가 다섯 번째 및 여섯 번째로 긴 책에 대한 컬렉션 쿼리합니다.

• 빈 쿼리 필터하다 사용하여 컬렉션 의 모든 문서를 일치시킵니다.

• sort() 메서드를 호출하여 length 필드 에 내림차순 정렬을 적용 긴 책이 짧은 책보다 먼저 반환됩니다.

• skip() 메서드를 호출하여 결과에서 일치하는 처음 4개의 문서를 생략합니다.

// define an empty query document
const query = {};
const sortFields = { length: -1 };
const skipNum = 4;
const cursor = myColl.find(query).sort(sortFields).skip(skipNum);
for await (const doc of cursor) {
  console.dir(doc);
}

쿼리 일치하는 처음 4개의 문서를 건너뛰므로 앞의 코드 스니펫은 길이가 다섯 번째와 여섯 번째로 긴 문서를 출력합니다.

{ "_id": 5, "title": "Cryptonomicon", "author": "Stephenson", "length": 918 }
{ "_id": 1, "title": "The Brothers Karamazov", "author": "Dostoyevsky", "length": 824 }

제한, 정렬 및 건너뛰기 결합

단일 작업으로 limit, sort 및 skip 옵션을 결합할 수 있습니다. 이렇게 하면 지정된 수의 문서를 건너뛰고 반환할 정렬된 최대 문서 수를 설정하다 수 있습니다.

다음 예시 length 값이 "1104"인 문서를 반환합니다. 결과는 알파벳순으로 정렬되며 첫 번째 문서 건너뛰고 첫 번째 결과만 포함합니다.

const query = {length: "1104"};
const cursor = myColl.find(query).sort({ title: 1 }).skip(1).limit(1);
for await (const doc of cursor) {
   console.dir(doc);
}

{ "_id": 4, "title": "Infinite Jest", "author": "Wallace", "length": 1104 }

추가 정보

쿼리 지정에 대한 자세한 내용은 쿼리 작업을 참조하세요.

문서 검색에 대한 자세한 내용은 문서 찾기를 참조하세요.