MongoDB를 Node.js와 연결하는 것은 현대 웹 개발자에게 중요한 기술입니다. 이 가이드에서는 이러한 강력한 기술을 쉽게 통합할 수 있도록 프로세스를 단계별로 안내합니다.

소개

NoSQL 데이터베이스의 선두주자인 MongoDB는 유연성과 확장성으로 유명합니다. 강력한 JavaScript 런타임인 Node.js를 사용하면 효율적이고 확장 가능한 웹 애플리케이션을 구축할 수 있습니다. 이 연결을 원활하게 만드는 단계를 자세히 살펴보겠습니다.

목차

1. 전제조건
2. MongoDB 설정
3. Node.js 프로젝트 시작
4. Mongoose를 사용하여 MongoDB에 연결
5. 연결 테스트
6. 결론

1. 전제조건

• JavaScript와 Node.js에 대한 기본 이해
• Node.js 및 npm(노드 패키지 관리자)이 시스템에 설치되어 있습니다.
• MongoDB 계정 및 로컬/원격 MongoDB 서버.

2. 몽고DB 설정

먼저 MongoDB를 머신에 설치하거나 MongoDB Atlas를 통해 클라우드 인스턴스를 설정하세요. 곧 필요하므로 연결 문자열을 저장하세요.

MongoDB Atlas에서 MongoDB 설정

2.1 회원가입 또는 로그인

• MongoDB Atlas 웹사이트로 이동: https://www.mongodb.com/cloud/atlas
• MongoDB Atlas를 처음 사용하는 경우 새 계정에 가입하세요. 그렇지 않은 경우에는 자격 증명으로 로그인하세요.

2.2 새 클러스터 생성

• 로그인한 후 '새 클러스터 생성' 버튼을 클릭하세요.
• MongoDB Atlas는 M0 Sandbox로 알려진 무료 계층을 제공합니다. 이는 초보자나 소규모 프로젝트를 위한 좋은 출발점입니다.

2.3 클라우드 제공업체 및 지역 선택

• 선호하는 클라우드 제공업체(AWS, Google Cloud 또는 Azure)를 선택하세요.
• 지역을 선택하세요. 일부 지역에서는 무료 등급을 지원하므로 대기 시간을 줄이기 위해 기본 사용자 기반에 가장 가까운 지역을 선택해야 합니다.

2.4 클러스터 설정 구성

• 기본 설정은 대부분의 사용 사례에 적합하지만 필요한 경우 클러스터 이름과 기타 설정을 수정할 수 있습니다.

2.5 추가 구성 추가(선택 사항)

• 추가 설정에서 백업을 구성하거나 모니터링을 활성화하거나 기타 고급 구성을 수행할 수 있습니다. 대부분의 초보자에게는 기본 설정으로 충분합니다.

2.6 네트워크 액세스 설정

• 왼쪽 패널에서 '데이터베이스 액세스' 섹션을 클릭하세요.
• 사용자 이름과 강력한 비밀번호를 사용하여 새 사용자를 추가하세요. 애플리케이션을 MongoDB에 연결하는 데 필요하므로 이러한 자격 증명을 기억하세요.
• "IP 화이트리스트" 탭에서 "IP 주소 추가"를 클릭하세요. 보안을 위해 액세스가 필요한 IP만 화이트리스트에 추가하세요. 개발 목적으로 "어디서나 액세스 허용"을 선택할 수 있지만 보안 문제로 인해 프로덕션 환경에서는 권장되지 않습니다.

2.7 연결 문자열 가져오기

• 클러스터가 실행되면 '연결' 버튼을 클릭하세요.
• "애플리케이션 연결"을 선택하세요.
• 드라이버 버전을 선택하고 연결 문자열을 복사합니다. 이는 애플리케이션에서 MongoDB에 연결하는 데 사용할 문자열입니다. 연결 문자열을 이전에 생성한 MongoDB 사용자의 비밀번호로 바꿉니다.

2.8 애플리케이션 연결

• 애플리케이션에서 복사한 연결 문자열을 사용하여 MongoDB 클라우드 인스턴스와 상호 작용을 시작하세요.

2.9 모니터링 및 관리

• MongoDB Atlas는 쿼리, 성능 및 기타 측정항목을 모니터링할 수 있는 대시보드를 제공합니다. 데이터베이스의 상태와 성능을 확인하려면 이를 정기적으로 확인하세요.

3. Node.js 프로젝트 시작

터미널 또는 명령 프롬프트에서:

mkdir mongo-node-connection
cd mongo-node-connection
npm init -y

위 코드는 새로운 Node.js 프로젝트를 생성합니다.

4. Mongoose를 사용하여 MongoDB에 연결

Mongoose는 Node.js와 MongoDB 간의 연결을 용이하게 하는 널리 사용되는 ODM(Object Document Mapper)입니다.

몽구스 설치:

npm install mongoose

MongoDB에 연결:

const mongoose = require('mongoose');

// Your MongoDB connection string
const dbURI = 'YOUR_MONGODB_CONNECTION_STRING';

mongoose.connect(dbURI, { useNewUrlParser: true, useUnifiedTopology: true })
  .then(() => console.log('Connected to MongoDB'))
  .catch((error) => console.error('Connection error', error));

참고: 'YOUR_MONGODB_CONNECTION_STRING'을 실제 MongoDB 연결 문자열로 바꾸세요.

5. 연결 테스트

연결을 확인하려면:

• Mongoose를 사용하여 간단한 스키마와 모델을 만듭니다.
• MongoDB 컬렉션에 문서를 삽입합니다.
• 문서를 가져와 콘솔에 기록합니다.

const testSchema = new mongoose.Schema({
  name: String,
  testField: String
});

const TestModel = mongoose.model('Test', testSchema);

const testData = new TestModel({
  name: 'Node-Mongo Connection Test',
  testField: 'It works!'
});

testData.save()
  .then(doc => {
    console.log('Test document saved:', doc);
  })
  .catch(error => {
    console.error('Error saving test document:', error);
  });

Node.js 스크립트를 실행하고 모든 것이 올바르게 설정되면 콘솔에 기록된 테스트 문서를 볼 수 있습니다.

6. 결론

MongoDB를 Node.js와 연결하면 강력한 데이터베이스 솔루션을 제공하여 웹 애플리케이션을 향상시킬 수 있습니다. 이 가이드를 따르면 Mongoose를 사용하여 기본 연결을 설정하고 향후 고급 작업 및 쿼리를 위한 기반을 마련했습니다.