PromleeBlog
sitemap
aboutMe

posting thumbnail
MongoDB 주요 툴과 유틸리티 (Compass, mongodump, mongorestore, mongoimport, mongoexport) - MongoDB 올인 12일차
Key MongoDB Tools and Utilities (Compass, mongodump, mongorestore, mongoimport, mongoexport) - All-in Day 12

📅
🚀 들어가기 전에
🚀 1. MongoDB Compass
✅ Compass의 주요 기능
✅ Compass 설치 및 사용
🚀 2. mongodump와 mongorestore: 데이터 백업과 복원
✅ mongodump
✅ mongorestore
🚀 3. mongoimport와 mongoexport
✅ mongoexport
✅ mongoimport
🚀 결론
✅ 참고
🚀

들어가기 전에 🔗

지난 시간에는 클라우드에서 MongoDB를 손쉽게 운영할 수 있는 MongoDB Atlas에 대해 배웠습니다.
Atlas 자체도 훌륭한 관리 기능을 제공하지만, MongoDB 생태계에는 개발과 운영 작업을 더욱 효율적으로 만들어주는 다양한 도구와 유틸리티들이 존재합니다.
데이터를 시각적으로 보고 싶을 때, 데이터를 안전하게 백업하고 싶을 때, 또는 다른 형식의 데이터를 MongoDB로 가져오거나 내보내고 싶을 때 이 도구들이 큰 도움이 될 것입니다.
🚀

1. MongoDB Compass 🔗

GUI 도구
MongoDB Compass는 MongoDB에서 공식적으로 제공하는
그래픽 사용자 인터페이스(GUI)
도구입니다.
우리가 지금까지 mongosh 라는 명령줄 인터페이스(CLI)를 통해 텍스트 기반으로 MongoDB와 상호작용했다면, Compass는 마우스 클릭과 시각적인 화면을 통해 데이터베이스를 탐색하고 관리할 수 있게 해줍니다.
✅

Compass의 주요 기능 🔗

✅

Compass 설치 및 사용 🔗

MongoDB Compass는 여러분의 MongoDB 개발 및 관리 작업을 훨씬 편리하게 만들어 줄 수 있는 강력한 도구입니다. 설치 과정도 매우 간단합니다.
➡️

Compass 다운로드 🔗

먼저, MongoDB 공식 웹사이트의 Compass 다운로드 페이지로 이동합니다.
https://www.mongodb.com/try/download/compass↗
웹페이지가 열리면, 여러분의 운영체제(Windows, macOS, Linux)에 맞는 버전이 자동으로 감지되거나 선택할 수 있도록 옵션이 제공됩니다.
'Download' 버튼을 클릭하여 설치 파일을 다운로드합니다.
다운로드 페이지
다운로드 페이지
➡️

운영체제별 설치 진행 🔗

Windows
  1. 다운로드한 .msi 설치 파일을 더블 클릭하여 실행합니다.
  2. 설치 마법사의 안내에 따라 진행합니다. 보통 'Next'를 몇 번 클릭하고 라이선스에 동의하면 설치가 완료됩니다. 특별히 변경할 옵션은 거의 없습니다.
  3. 설치가 완료되면 시작 메뉴나 바탕화면에서 MongoDB Compass를 실행할 수 있습니다.
macOS
  1. 다운로드한 .dmg 파일을 더블 클릭하여 엽니다.
  2. 보통 MongoDB Compass 아이콘을 응용 프로그램(Applications) 폴더 아이콘으로 드래그 앤 드롭하는 방식으로 설치합니다.
    드래그 앤 드롭
    드래그 앤 드롭
  3. 설치가 완료되면 Launchpad나 응용 프로그램 폴더에서 MongoDB Compass를 실행할 수 있습니다. 처음 실행 시 보안 경고가 나타날 수 있으며, '열기'를 선택하면 됩니다.
Linux
➡️

Compass 실행 및 서버 연결 🔗

Compass를 처음 실행하면, 새로운 연결(New Connection)을 설정하는 화면이 나타납니다.
여기에 MongoDB 서버에 접속하기 위한
연결 문자열(Connection String URI)
을 직접 입력하거나, 개별 필드(Hostname, Port, Authentication 등)를 채워 넣을 수 있습니다.
로컬 서버 접속 시
: 기본 설정(mongodb://localhost:27017)으로 접속을 시도해 볼 수 있습니다.
MongoDB Atlas 클러스터 접속 시
: Atlas 대시보드에서 제공하는 연결 문자열을 복사하여 붙여넣는 것이 가장 편리합니다. (11일차 Atlas 시작 가이드 참고)
'New Connection' 화면
'New Connection' 화면
필요한 인증 정보(사용자 이름, 비밀번호)를 입력하고 'Connect' 버튼을 클릭합니다.
성공적으로 연결되면 Compass의 메인 화면으로 이동하여 데이터베이스와 컬렉션을 탐색할 수 있습니다.
Atlas 데이터베이스와 컬렉션 연결 화면
Atlas 데이터베이스와 컬렉션 연결 화면
MongoDB를 처음 배우는 학생분들이나 명령줄 환경이 익숙하지 않은 분들에게 Compass는 데이터베이스의 구조를 이해하고 기본적인 작업을 수행하는 데 매우 유용한 도구입니다.
다양한 기능을 직접 사용해보면서 MongoDB와 더 친숙해지시길 바랍니다.
🚀

2. mongodump와 mongorestore: 데이터 백업과 복원 🔗

데이터는 매우 소중하므로, 예기치 않은 문제(하드웨어 장애, 사용자 실수 등)로부터 데이터를 보호하기 위해 정기적인
백업(Backup)
이 필수적입니다.
mongodump 와 mongorestore 는 MongoDB 데이터를 백업하고 복원하는 데 사용되는 명령줄 유틸리티입니다.
✅

mongodump 🔗

데이터베이스 백업하기
mongodump 는 MongoDB 서버에서 데이터를 BSON(Binary JSON) 형식의 파일로 내보내어 백업을 생성합니다.
➡️

기본 사용법 🔗

mongodump --uri="mongodb://<username>:<password>@host:<port>/<databaseName>" --out="/path/to/backup_directory"
➡️

주요 옵션 🔗

➡️

예시 🔗

test 데이터베이스 전체를 ~/mongodb 디렉토리에 압축하여 백업하기
mongodump --uri="mongodb://localhost:27017/test" --out="~/mongodb"
mongodump 실행 결과
mongodump 실행 결과
✅

mongorestore 🔗

백업 데이터 복원하기
mongorestore 는 mongodump 로 생성된 백업 파일(BSON)을 MongoDB 서버로 다시 가져와 데이터를 복원합니다.
➡️

기본 사용법 🔗

mongorestore --uri="mongodb://<username>:<password>@<host>:<port>/<targetDatabaseName>" /path/to/backup_directory
➡️

주요 옵션 🔗

➡️

예시 🔗

위에서 백업한 내용을 restoredDB 데이터베이스로 복원하기
mongorestore --uri="mongodb://localhost:27017/restoredDB" ~/mongodb/test
복원 완료
복원 완료
👨‍💻
mongodump와 mongorestore는 데이터 마이그레이션, 개발 환경 구축 등 다양한 상황에서 유용하게 사용됩니다.
🚀

3. mongoimport와 mongoexport 🔗

데이터 형식 변환
때로는 MongoDB 데이터를 다른 형식(JSON, CSV 등)으로 내보내거나, 다른 형식의 데이터를 MongoDB로 가져와야 할 때가 있습니다.
mongoimport 와 mongoexport 는 이러한 작업을 위한 명령줄 유틸리티입니다.
✅

mongoexport 🔗

MongoDB 데이터를 외부 파일로 내보내기
mongoexport 는 컬렉션의 데이터를 JSON, CSV, TSV 형식으로 내보냅니다.
➡️

기본 사용법 (JSON) 🔗

mongoexport --uri="mongodb://username:password@host:port/databaseName" --collection="collectionName" --out="output_file.json"
➡️

주요 옵션 🔗

➡️

예시 🔗

users 컬렉션에서 "active" 상태 사용자들의 name, email을 CSV로 내보내기
아래 명령어로 test 컬렉션에 데이터를 생성해줍니다.
db.users.insertMany([
  { name: "Alice", email: "alice@example.com", status: "active" },
  { name: "Bob", email: "bob@example.com", status: "disabled" },
  { name: "Charlie", email: "charlie@example.com", status: "active" },
  { name: "Daisy", email: "daisy@example.com", status: "inactive" }
])
mongoexport --uri="mongodb://localhost:27017/test" --collection="users" --type="csv" --fields="name,email" --query='{"status": "active"}' --out="active_users.csv"
CSV 파일 생성 결과
CSV 파일 생성 결과
✅

mongoimport 🔗

외부 데이터를 MongoDB로 가져오기
mongoimport 는 JSON, CSV, TSV 형식의 파일 데이터를 MongoDB 컬렉션으로 가져옵니다.
➡️

기본 사용법 (JSON) 🔗

mongoimport --uri="mongodb://username:password@host:port/databaseName" --collection="collectionName" --file="input_file.json"
주요 옵션 🔗
예시 🔗
위에서 내보낸 active_users.csv 파일을 importedUsers 컬렉션으로 가져오기
mongoimport --uri="mongodb://localhost:27017/test" --collection="importedUsers" --type="csv" --headerline --file="active_users.csv"
mongoimport 결과
mongoimport 결과
🚀

결론 🔗

오늘은 MongoDB를 사용하면서 우리의 작업을 훨씬 편리하고 효율적으로 만들어주는 주요 도구와 유틸리티들에 대해 알아보았습니다.
시각적인 데이터 관리를 위한 MongoDB Compass의 설치 및 사용법, 안정적인 데이터 백업과 복원을 위한 mongodump와 mongorestore, 그리고 다양한 형식의 데이터를 MongoDB와 주고받을 수 있게 해주는 mongoimport와 mongoexport까지, 각각의 특징과 사용법을 살펴보았습니다.
이러한 도구들을 잘 활용하면 MongoDB 개발 및 운영의 생산성을 크게 높일 수 있습니다.
다음 시간에는 프로그래밍 언어와 MongoDB를 연동하는 방법을 배워 보겠습니다.
Node.js 환경에서 MongoDB Atlas 클러스터에 접속하여 기본적인 CRUD 작업을 수행하는 방법에 대해 자세히 알아보겠습니다.
✅

참고 🔗