← 목록

MongoDB와 Node.js를 이용한 데이터베이스 연동 방법

작성: 2025년 09월 22일읽기: 약 3분

웹 개발에 관심이 많은 주니어 개발자 여러분, 오늘은 MongoDB 데이터베이스를 Node.js 애플리케이션에 연동하는 방법을 쉽게 설명해드리겠습니다. MongoDB는 유연하고 확장 가능한 데이터베이스 시스템으로, 다양한 웹 프로젝트에 널리 사용됩니다. Node.js와 함께 사용하면 강력한 백엔드 시스템을 구축할 수 있습니다.

시작하기 전에

Node.js가 설치되어 있어야 하며, MongoDB 계정이 있어야 합니다. 또한, MongoDB 데이터베이스에 접근할 수 있는 URL이 필요합니다.

첫 번째 단계: 프로젝트 설정

Node.js 프로젝트를 시작하기 위해, 새 폴더를 만들고 해당 폴더에서 다음 명령어를 실행합니다.

npm init -y

이 명령어는 기본 설정으로 package.json 파일을 생성합니다.

두 번째 단계: 필요한 패키지 설치

MongoDB를 Node.js와 연동하기 위해 mongoose 패키지를 설치해야 합니다. mongoose는 MongoDB와의 상호작용을 쉽게 만들어주는 Node.js 라이브러리입니다.

npm install mongoose

세 번째 단계: MongoDB 연결

이제 mongoose를 사용하여 MongoDB 데이터베이스에 연결해봅시다. 프로젝트의 루트에 index.js 파일을 생성하고 다음 코드를 추가합니다.

const mongoose = require('mongoose');

// MongoDB URL. 실제 프로젝트에서는 여러분의 데이터베이스 URL을 사용하세요.
const mongoDBUrl = 'your_mongodb_url_here';

mongoose.connect(mongoDBUrl, { useNewUrlParser: true, useUnifiedTopology: true })
  .then(() => console.log('MongoDB에 성공적으로 연결되었습니다!'))
  .catch(err => console.error('MongoDB 연결에 실패했습니다:', err));

your_mongodb_url_here 부분을 실제 MongoDB 데이터베이스 URL로 교체해주세요.

네 번째 단계: 간단한 데이터 모델 생성

데이터베이스에 데이터를 저장하기 위해서는 모델이 필요합니다. User라는 간단한 모델을 만들어 보겠습니다.

const UserSchema = new mongoose.Schema({
  name: String,
  email: String,
  age: Number
});

const User = mongoose.model('User', UserSchema);

이 코드는 사용자의 이름, 이메일, 나이를 저장할 수 있는 간단한 스키마를 정의합니다.

다섯 번째 단계: 데이터 저장하기

이제 새로운 사용자를 생성하고 데이터베이스에 저장해봅시다.

const newUser = new User({
  name: 'John Doe',
  email: 'john@example.com',
  age: 30
});

newUser.save()
  .then(doc => console.log('새 사용자가 저장되었습니다:', doc))
  .catch(err => console.error('사용자 저장 실패:', err));

이 코드는 새 User 인스턴스를 생성하고, .save() 메소드를 호출하여 MongoDB 데이터베이스에 저장합니다.

여기까지 MongoDB 데이터베이스를 Node.js 애플리케이션에 연동하는 방법을 살펴보았습니다. 이 과정을 통해 데이터를 저장하고 관리하는 기본적인 방법을 이해할 수 있습니다. 웹 개발 프로젝트에 MongoDB를 효과적으로 활용해보세요!