Node.js - MongoDB Find

안녕하세요, 야심찬 프로그래머 여러분! 오늘 우리는 Node.js와 MongoDB의 세계로 흥미로운 여정을 떠납니다. 특히, Node.js를 사용하여 MongoDB 데이터베이스에서 데이터를 검색하는 방법을 탐구해보겠습니다. 초보자라면 걱정하지 마세요 - 우리는 기초부터 시작하여 점진적으로 학습해 나갈 것입니다. 이 튜토리얼이 끝나면, 당신은 프로처럼 문서를 찾을 수 있을 것입니다!

MongoDB와 Node.js 소개

문서 검색의 구체적인 내용에 들어가기 전에, MongoDB와 Node.js가 무엇인지 간단히 이해해보겠습니다.

MongoDB는 유연한 JSON 같은 문서로 데이터를 저장하는 인기 있는 NoSQL 데이터베이스입니다. 마치 다양한 정보를 저장할 수 있는 거대한 디지털 파일 캐비닛과 같습니다.

반면에 Node.js는 JavaScript 런타임으로, 컴퓨터에서 브라우저 밖에서 JavaScript를 실행할 수 있게 해줍니다. JavaScript에게 컴퓨터의 파일 시스템, 네트워크, 그리고 MongoDB와 같은 데이터베이스와 상호작용할 수 있는 초능력을 주는 것입니다.

이제 코드로 손을 댄 채로 시작해보겠습니다!

환경 설정

우선, 프로젝트를 설정해야 합니다. 다음과 같이 하세요:

아직 설치하지 않았다면 Node.js를 공식 웹사이트에서 설치하세요.
프로젝트를 위한 새로운 디렉토리를 생성합니다.
해당 디렉토리에서 터미널을 엽니다 و npm init -y를 실행하여 package.json 파일을 생성합니다.
MongoDB 드라이버를 설치하기 위해 npm install mongodb를 실행합니다.

훌륭합니다! 이제 코드 작성을 시작할 준비가 되었습니다.

MongoDB에 연결

문서를 찾기 전에 MongoDB 데이터베이스에 연결해야 합니다. 이렇게 합니다:

const { MongoClient } = require('mongodb');

const url = 'mongodb://localhost:27017';
const dbName = 'myProject';

async function connectToDatabase() {
const client = new MongoClient(url);

try {
await client.connect();
console.log('데이터베이스에 성공적으로 연결되었습니다');
const db = client.db(dbName);
return db;
} catch (error) {
console.error('데이터베이스 연결에 실패했습니다', error);
throw error;
}
}

이를 설명하자면:

MongoClient를 mongodb 패키지에서 임포트합니다.
MongoDB 서버가 실행 중인 URL과 데이터베이스 이름을 지정합니다.
connectToDatabase()라는 비동기 함수를 생성하여 MongoDB 서버에 연결합니다.
연결이 성공하면 데이터베이스 객체를 반환하고, 실패하면 오류를 로그합니다.

모든 문서 읽기

이제 연결이 되었으므로, 컬렉션에서 모든 문서를 검색하는 방법을 배워보겠습니다. find() 메서드를 사용합니다.

async function findAllDocuments(db, collectionName) {
const collection = db.collection(collectionName);

try {
const documents = await collection.find({}).toArray();
console.log('다음 문서를 찾았습니다:');
console.log(documents);
return documents;
} catch (error) {
console.error('문서 찾는 중 오류 발생:', error);
throw error;
}
}

이 작업은 다음과 같습니다:

db.collection(collectionName)을 사용하여 컬렉션에 대한 참조를 가져옵니다.
find({})를 사용하여 모든 문서를 검색합니다. 빈 객체 {}은 어떤 필터를 적용하지 않는다는 것을 의미합니다.
결과를 배열로 변환하여 toArray()를 사용합니다.
문서를 로그하고 반환합니다.

이 함수를 사용하려면 다음과 같이 합니다:

async function main() {
const db = await connectToDatabase();
await findAllDocuments(db, 'users');
}

main().catch(console.error);

이렇게 하면 'users' 컬렉션에서 모든 문서를 찾습니다.

findOne() 사용

occasionally, you only need to retrieve a single document. That's where findOne() comes in handy. Let's create a function for this:

async function findOneDocument(db, collectionName, query) {
const collection = db.collection(collectionName);

try {
const document = await collection.findOne(query);
if (document) {
console.log('문서를 찾았습니다:');
console.log(document);
} else {
console.log('쿼리에 일치하는 문서가 없습니다.');
}
return document;
} catch (error) {
console.error('문서 찾는 중 오류 발생:', error);
throw error;
}
}

이 함수는 다음과 같은 작업을 수행합니다:

findOne(query)를 사용하여 쿼리와 일치하는 단일 문서를 검색합니다.
문서가 발견되면 로그하고 반환하고, 발견되지 않으면 메시지를 로그합니다.

이 함수를 사용하려면 다음과 같이 합니다:

async function main() {
const db = await connectToDatabase();
await findOneDocument(db, 'users', { name: 'John Doe' });
}

main().catch(console.error);

이렇게 하면 이름이 'John Doe'인 첫 번째 사용자를 찾습니다.

메서드 표

다음은 우리가 다루었던 메서드의 유용한 표입니다:

메서드	설명	예제
`find()`	여러 문서 검색	`collection.find({})`
`findOne()`	단일 문서 검색	`collection.findOne({ name: 'John' })`

결론

축하합니다! 지금까지 Node.js를 사용하여 MongoDB에서 문서를 찾는 방법을 배웠습니다. 데이터베이스에 연결하고, 모든 문서를 검색하며, 단일 문서를 찾는 방법을 다루었습니다. 이러한 기술은 거의 모든 MongoDB 프로젝트에서 사용될 것입니다.

기억하시라, 연습이 완성을 이루는 길입니다. 이 개념들을 적용할 수 있는 작은 프로젝트를 만들어보세요. 예를 들어, 간단한 주소록이나 할 일 목록은 어떠세요? 가능성은 무한합니다!

행복하게 코딩하시고, 항상 원하는 문서를 찾으세요!

Credits: Image by storyset