MongoDB Database Tools (Install)

데이터 백업 및 복원

mongodump 명령은 MongoDB 인스턴스의 데이터를 바이너리 BSON 형식으로 디스크에 백업합니다. mongorestore 명령은 이러한 백업을 살아있는 MongoDB 데이터베이스로 복원할 수 있습니다. 이 기능은 독립형, 레플리카 세트, 샤드 클러스터 배포 모두에서 작동합니다.

데이터 가져오기 및 내보내기

mongoimport 도구는 확장 JSON, CSV 또는 TSV 파일의 데이터를 MongoDB 컬렉션으로 가져옵니다. mongoexport 도구는 MongoDB 컬렉션의 데이터를 JSON 또는 CSV 형식으로 내보냅니다. 이 도구들은 시스템 명령줄에서 실행되어야 하며, mongo 셸 내부에서는 작동하지 않습니다.

데이터베이스 모니터링

mongostat 유틸리티는 현재 실행 중인 mongod 또는 mongos 인스턴스의 상태를 실시간으로 보여줍니다. 삽입, 쿼리, 업데이트, 삭제 작업 수 및 가상 메모리 사용량 등을 포함합니다. mongotop은 mongod 인스턴스가 읽기 및 쓰기에 소비하는 시간을 보여줍니다.

GridFS 파일 관리

mongofiles 도구는 MongoDB의 GridFS 스토리지에 파일을 읽고, 쓰고, 삭제하거나 업데이트할 수 있게 해줍니다. 이는 데이터베이스 내에 큰 바이너리 파일을 저장하고 관리해야 하는 경우에 유용합니다.

다운로드·설치 방법

이 도구들은 Chocolatey 패키지 관리자를 통해 Windows에 설치할 수 있습니다. 공식 Chocolatey 패키지 이름은 mongodb-database-tools이며, 관리자 권한으로 PowerShell 또는 명령 프롬프트에서 다음 명령을 실행하여 설치할 수 있습니다:

choco install mongodb-database-tools

설치 후, 도구들은 시스템 PATH에 등록되어 명령 프롬프트에서 바로 사용할 수 있습니다. 각 도구의 도움말을 보려면 [도구 이름] --help 형식으로 실행하면 됩니다(예: mongodump --help).

기본 사용법/명령어

데이터베이스를 백업하려면 다음 명령을 실행합니다:

mongodump --out /path/to/backup/directory

백업된 데이터를 복원하려면:

mongorestore /path/to/backup/directory

JSON 파일을 컬렉션으로 가져오려면:

mongoimport --collection=mycollection --file=data.json

컬렉션을 JSON 파일로 내보내려면:

mongoexport --collection=mycollection --out=data.json

데이터베이스 상태를 모니터링하려면:

mongostat

읽기/쓰기 활동을 확인하려면:

mongotop

이런 경우에 유용합니다

정기적인 데이터베이스 백업이 필요한 개발자나 DBA는 mongodump과 mongorestore를 사용하여 백업 전략을 수립할 수 있습니다. 외부 시스템에서 JSON 또는 CSV 형식의 데이터를 MongoDB로 이전해야 할 때는 mongoimport를, MongoDB의 데이터를 다른 시스템과 공유하거나 분석해야 할 때는 mongoexport를 사용합니다. 실시간으로 데이터베이스 성능을 추적하고 병목 현상을 진단해야 하는 운영 담당자는 mongostat과 mongotop을 활용할 수 있습니다. GridFS에 저장된 이미지나 파일 등을 프로그래밍 방식으로 관리해야 하는 애플리케이션 개발자는 mongofiles를 통해 파일 업로드, 다운로드, 삭제 등을 수행할 수 있습니다.

지원 환경·시스템 요구사항

이 도구들은 Windows 운영 체제에서 실행됩니다. 공식 문서에 명시된 구체적인 시스템 요구사항은 제공된 증거에 포함되어 있지 않습니다.

최신 버전·업데이트

현재 버전은 100.17.0입니다. 이 버전은 Go 모듈을 사용하여 의존성을 관리하며, go.mod 파일에 모든 의존성이 명시되어 있습니다. 의존성을 업데이트하거나 수정해야 할 경우, go mod edit 명령을 사용하여 go.mod 파일을 수정한 후 go mod vendor를 실행하여 공급업체 디렉터리를 재구성할 수 있습니다.

제한 사항·확인 사항

이 도구들은 MongoDB 데이터베이스와 함께 작동하도록 설계되었으며, 독립적으로 MongoDB 서버를 제공하지 않습니다. MongoDB 인스턴스에 연결하여 작동해야 하므로, 별도로 MongoDB 서버가 설치 및 실행되어 있어야 합니다. 일부 도구(예: macOS 전용 빌드 바이너리)는 실행 전에 코드 서명이 필요할 수 있지만, Windows 버전에서는 이와 같은 제한이 적용되지 않습니다.