문서 수 계산

개요

이 가이드 에서는 MongoDB 컬렉션의 문서 수를 계산하는 방법을 학습 수 있습니다. Node.js 운전자 컬렉션 의 문서 수를 계산하는 두 가지 방법을 제공합니다.

컬렉션 .countDocuments() 는 지정된 쿼리 와 일치하는 컬렉션 의 문서 수를 반환합니다. 빈 쿼리 문서 를 지정하면 countDocuments() 은 컬렉션 의 총 문서 수를 반환합니다.
collection.estimatedDocumentCount()는 컬렉션 메타데이터를 기반으로 컬렉션의 문서 수에 대한 추정치를 반환합니다.

estimatedDocumentCount() , 추정 시 collection을 스캔하는 대신 collection의 메타데이터를 사용하므로 countDocuments()보다 빠릅니다. 반면 countDocuments()은 반환하는 데 시간이 더 오래 걸리지만 문서 수를 정확하게 계산하고 필터 지정을 지원합니다. 워크로드에 적합한 방법을 선택하세요.

계산할 문서를 지정하기 위해 countDocuments() 은 쿼리 매개변수를 허용합니다. countDocuments() 는 지정된 쿼리 와 일치하는 문서의 수를 계산합니다.

countDocuments() 그리고 estimatedDocumentCount()는 메소드 실행에 영향을 미치는 선택적 설정을 지원합니다. 자세한 내용은 각 메소드에 대한 참고 문서를 참조하세요.

팁

컬렉션 스캔을 피함으로써 countDocuments() 명령을 사용하여 컬렉션의 총 문서 수를 반환할 때 성능을 향상시킬 수 있습니다. 이렇게 하려면 힌트 를 사용하여 _id 필드에 내장된 인덱스를 활용하세요. 빈 쿼리 매개 변수를 사용하여 countDocuments()를 호출할 때만 이 방법을 사용하세요.

collection.countDocuments({}).hint("_id");

countDocuments() 예제: 전체 파일

참고

설정 예시

이 예시 연결 URI를 사용하여 MongoDB 인스턴스 에 연결합니다. MongoDB 인스턴스에 연결하는 방법에 대해 자세히 학습하려면 MongoDB 에 연결 가이드를 참조하세요. 이 예시 Atlas 샘플 데이터 세트에 포함된 sample_mflix 데이터베이스의 movies 컬렉션도 사용합니다. Atlas 시작하기 가이드에 따라 MongoDB Atlas 의 무료 계층 에서 데이터베이스 에 로드할 수 있습니다.

참고

타입스크립트 (Typescript) 관련 기능 없음

다음 코드 예시 JavaScript 사용합니다. 이 사용 사례 와 관련된 운전자 의 타입스크립트 (Typescript) 특정 기능은 없습니다.

다음 예시 sample_mflix 데이터베이스 의 movies 컬렉션 에 있는 문서 수를 추정한 다음 countries 필드 에 Canada 이 있는 movies 컬렉션 의 문서 수에 대한 정확한 개수를 반환합니다.

1 // Count documents in a collection
2 
3 import { MongoClient } from "mongodb";
4 
5 // Replace the uri string with your MongoDB deployment's connection string
6 const uri = "<connection string uri>";
7 
8 const client = new MongoClient(uri);
9 
10 async function run() {
11   try {
12     const database = client.db("sample_mflix");
13     const movies = database.collection("movies");
14 
15     /* Print the estimate of the number of documents in the
16     "movies" collection */
17     const estimate = await movies.estimatedDocumentCount();
18     console.log(`Estimated number of documents in the movies collection: ${estimate}`);
19 
20     /* Print the number of documents in the "movies" collection that
21     match the specified query */
22     const query = { countries: "Canada" };
23     const countCanada = await movies.countDocuments(query);
24     console.log(`Number of movies from Canada: ${countCanada}`);
25   } finally {
26     // Close the connection after the operations complete
27     await client.close();
28   }
29 }
30 // Run the program and print any thrown exceptions
31 run().catch(console.dir);

앞의 샘플 코드를 실행하면 다음과 같은 결과가 출력됩니다.

Estimated number of documents in the movies collection: 23541
Number of movies from Canada: 1349

API 문서

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

돌아가기

쿼리 지정

고유 필드 값

1	// Count documents in a collection
2
3	import { MongoClient } from "mongodb";
4
5	// Replace the uri string with your MongoDB deployment's connection string
6	const uri = "<connection string uri>";
7
8	const client = new MongoClient(uri);
9
10	async function run() {
11	try {
12	const database = client.db("sample_mflix");
13	const movies = database.collection("movies");
14
15	/* Print the estimate of the number of documents in the
16	"movies" collection */
17	const estimate = await movies.estimatedDocumentCount();
18	console.log(`Estimated number of documents in the movies collection: ${estimate}`);
19
20	/* Print the number of documents in the "movies" collection that
21	match the specified query */
22	const query = { countries: "Canada" };
23	const countCanada = await movies.countDocuments(query);
24	console.log(`Number of movies from Canada: ${countCanada}`);
25	} finally {
26	// Close the connection after the operations complete
27	await client.close();
28	}
29	}
30	// Run the program and print any thrown exceptions
31	run().catch(console.dir);