mongorestore

정의

mongorestore 프로그램은 mongodump에서 작성된 2진 데이터베이스 덤프나 표준 입력을 mongod 또는 mongos 인스턴스로 로드합니다. mongorestore 는 MongoDB Database Tools를 설치할 때 설치됩니다.

MongoDB Database Tools를 사용하여 자체 호스팅 배포서버에서 MongoDB Atlas로 마이그레이션할 수 있습니다. MongoDB Atlas는 클라우드에서의 MongoDB 배포서버를 위한 완전 관리형 서비스입니다. 자세한 내용은 mongorestore로 시드 구성을 참조하세요.

MongoDB Atlas로 마이그레이션할 수 있는 모든 방법을 알아보려면 데이터 마이그레이션 또는 가져오기를 참조하세요.

mongodump에서 생성된 BSON 파일을 소스 배포서버와 동일한 주 버전 또는 기능 호환성 버전을 실행하는 MongoDB 배포서버로 복원할 수 있습니다.

mongorestore 다음과 같은 동작 및 제한 사항이 있습니다.

• mongorestore 은(는) MongoDB Shell이 아닌 시스템 명령줄에서 실행해야 합니다.

• MongoDB는 동일한 컬렉션에 대해 여러 mongorestore 프로그램을 동시에 실행하는 것을 지원하지 않습니다.

• Queryable Encryption 또는 클라이언트 사이드 필드 레벨 암호화 (CSFLE)를 사용하는 컬렉션 에는 mongorestore를 사용할 수 없습니다.

구문

mongorestore 실행 시 다음 명령 구문을 사용하세요.

mongorestore <options> <connection-string> <directory or file to restore>

를 실행 때 사용할 수 있는 옵션은 옵션을 mongorestore 참조하세요.

인수 없이 를 실행 경우 기본값 설정은 로컬 mongorestore ./dump 디렉토리 의 데이터를 포트 에서 mongod 실행 로컬 인스턴스 로 복원 27017 것입니다.

mongorestore

다른 경로에 dump 디렉토리를 지정할 수도 있습니다. 예를 들어, 다음 명령은 ./downloads/dump 디렉토리의 데이터를 연결 문자열로 지정된 Atlas 클러스터로 복원합니다.

mongorestore --uri="<my-connection-string>" ./downloads/dump

제공된 디렉토리에서 mongorestore을(를) 복원할 때 필요에 따라 데이터베이스와 컬렉션을 만들고 진행 상황을 기록합니다.

2019-07-08T14:37:38.942-0400 preparing collections to restore from
2019-07-08T14:37:38.944-0400 reading metadata for test.bakesales from dump/test/bakesales.metadata.json
2019-07-08T14:37:38.944-0400 reading metadata for test.salaries from dump/test/salaries.metadata.json
2019-07-08T14:37:38.976-0400 restoring test.salaries from dump/test/salaries.bson
2019-07-08T14:37:38.985-0400 no indexes to restore
2019-07-08T14:37:38.985-0400 finished restoring test.salaries (10 documents, 0 failures)
2019-07-08T14:37:39.009-0400 restoring test.bakesales from dump/test/bakesales.bson
2019-07-08T14:37:39.011-0400 restoring indexes for collection test.bakesales from metadata
2019-07-08T14:37:39.118-0400 finished restoring test.bakesales (21 documents, 0 failures)
2019-07-08T14:37:39.118-0400 restoring users from dump/admin/system.users.bson
2019-07-08T14:37:39.163-0400 restoring roles from dump/admin/system.roles.bson
2019-07-08T14:37:39.249-0400 31 document(s) restored successfully. 0 document(s) failed to restore.

dump 디렉토리에서 특정 컬렉션 하나 또는 여러 개를 복원할 수도 있습니다. 예를 들어, 다음 작업은 dump 디렉토리의 해당 데이터 파일에서 test.purchaseorders 컬렉션을 복원합니다.

mongorestore --nsInclude=test.purchaseorders ./dump

dump 디렉토리에 지정된 네임스페이스에 해당하는 데이터 파일이 없는 경우, mongorestore 는 데이터를 복원하지 않습니다. 예를 들어 다음 명령은 dump 디렉토리에 해당 데이터가 없는 컬렉션 네임스페이스를 지정합니다.

mongorestore --nsInclude=foo.bar dump/

mongorestore 다음 메시지를 출력합니다.

2019-07-08T14:38:15.142-0400 preparing collections to restore from
2019-07-08T14:38:15.142-0400 0 document(s) restored successfully. 0 document(s) failed to restore.

이(가) 옵션, 메타데이터 파일 mongorestore 또는 덤프 디렉토리 이름에서 데이터베이스 정보를 찾을 수 없는 --nsInclude test 경우 데이터베이스 로 복원합니다. 예시 들어, 다음 mongorestore 명령은 bands.bson 파일 에서 복원합니다.

mongorestore ./bands.bson

./dump/music/bands.bson와(과) 같은 네임스페이스 정보나 경로가 없기 때문에 mongorestore 의 출력은 다음과 같습니다.

2026-01-23T11:26:31.821-0500 restoring test.bands from bands.bson
2026-01-23T11:26:31.867-0500 finished restoring test.bands (1 document, 0 failures)
2026-01-23T11:26:31.867-0500 1 document(s) restored successfully. 0 document(s) failed to restore.

mongorestore 데이터를 test 데이터베이스 의 bands 컬렉션 으로 복원합니다. 데이터베이스 와 컬렉션 존재하지 않는 경우 생성합니다.

mongorestore의 추가 예시는 mongorestore 예시를 참조하세요.

옵션

이 섹션에는 mongorestore의 모든 사용 가능한 옵션 정보가 포함되어 있습니다.

--archive=<file>

mongodump --archive에서 생성된 아카이브 파일에서 복원합니다. mongorestore는 지정된 아카이브 파일에서 복원하거나, 파일을 지정하지 않은 경우 표준 입력(stdin)에서 복원합니다.

아카이브 파일에서 복원하려면 --archive 옵션과 아카이브 파일 이름을 사용하여 mongorestore을(를) 실행합니다.

표준 입력에서 복원 하려면 --archive 옵션으로 mongorestore 를 실행 하고 파일 이름을 생략합니다.

다음 예시 표준 입력에서 복원 방법을 보여줍니다.

mongodump --archive | mongorestore --archive

이 명령 파이프라인 먼저 --archive 플래그로 mongodump 를 실행하여 출력을 stdout 또는 표준 출력으로 인쇄합니다. 그런 다음 | 파이프 연산자 사용하여 입력이 mongorestore의 표준 입력으로 파이프됩니다.

중요

• 옵션은 덤프 디렉토리 지정하는 옵션과 함께 사용할 --archive --dir 수 없습니다.

• --db 및 옵션은 아카이브 파일 에서 복원할 때 더 이상 사용되지 않습니다. 특정 데이터베이스 또는 컬렉션 복원 하려면 --collection 를 --nsInclude 사용합니다.

• --archive 옵션을 매개 변수와 함께 <path> mongorestore 사용하면 <path> 는 를 무시합니다.

--authenticationDatabase=<dbname>

지정한 --username이 생성된 인증 데이터베이스를 지정합니다. --username 및 --password 옵션과 함께 사용합니다.

인증 데이터베이스에 대한 자세한 내용은 인증 데이터베이스를 참조하세요.

GSSAPI (Kerberos), PLAIN (LDAP SASL) 또는 MONGODB-AWS authentication mechanisms를 사용하는 경우 --authenticationDatabase를 $external로 설정해야 합니다.

또는 URI connection string에서 직접 인증 데이터베이스를 지정할 수도 있습니다. --authenticationDatabase를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

--authenticationMechanism=<name>

기본값: SCRAM-SHA-1

인스턴스 또는 에 인증하는 mongorestore mongod 데 사용하는 인증 메커니즘 mongos 지정합니다.

버전 100.1.0에서 변경됨:

버전 100.1.0부터 mongorestore는 MongoDB Atlas 클러스터에 연결할 때 MONGODB-AWS 인증 메커니즘에 대한 지원을 추가합니다.

값	설명
SCRAM-SHA-1	SHA- 해시 함수를 사용하는RFC 표준 솔티드 챌린지 응답 인증 메커니즘.5802 1
SCRAM-SHA-256	SHA- 해시 함수를 사용하는RFC 표준 솔티드 챌린지 응답 인증 메커니즘.7677 256 featureCompatibilityVersion이 4.0으로 설정되어야 합니다.
MONGODB-X.509	MongoDB TLS/SSL 인증서 인증.
MONGODB-AWS	MongoDB Atlas 클러스터 연결에 사용하기 위한 AWS IAM 자격 증명을 사용하는 외부 인증입니다. AWS IAM 자격 증명을 사용하여 MongoDB Atlas 클러스터에 연결하기를 참조하세요. 버전 100 의 새로운 기능입니다.1.0.
GSSAPI (Kerberos)	Kerberos를 사용한 외부 인증. 이 메커니즘은 MongoDB Enterprise에서만 사용할 수 있습니다.
PLAIN (LDAP SASL)	LDAP를 사용한 외부 인증. PLAIN 을 사용해 데이터베이스 내 사용자를 인증할 수도 있습니다. PLAIN 은 비밀번호를 일반 텍스트로 전송합니다. 이 메커니즘은 MongoDB Enterprise에서만 사용할 수 있습니다.

또는 URI connection string에서 직접 인증 메커니즘을 지정할 수도 있습니다. --authenticationMechanism를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

--awsSessionToken=<AWS Session Token>

를 사용하고 AWS 액세스 키 ID 및 비밀 액세스 키 외에 세션 토큰을 사용하여 MongoDB Atlas cluster 에 연결하는 경우 다음에서 AWS 세션 토큰을 지정할 수 있습니다.MONGODB-AWS authentication mechanism

• 이 필드,

• 매개변수를 로 AWS_SESSION_TOKEN authMechanismProperties connection string설정하거나

• AWS_SESSION_TOKEN 환경 변수.

각각의 예는 AWS IAM 자격 증명을 사용하여 MongoDB Atlas Cluster에 연결하기를 참조하세요.

MONGODB-AWS authentication mechanism을(를) 사용할 때만 유효합니다.

--bypassDocumentValidation

작업 중에 mongorestore가 문서 유효성 검사를 우회하도록 설정합니다. 이를 통해 유효성 검사 요구 사항을 충족하지 않는 문서를 삽입할 수 있습니다.

--collection=<collection>, -c=<collection>

중요

디렉토리 또는 아카이브 파일 에서 복원할 때 --db 및 옵션 사용은 더 이상 사용되지 않습니다. 아카이브 또는 --collection --nsInclude 디렉토리 에서 특정 데이터베이스 또는 컬렉션 복원 하려면 를 참조하세요.

BSON 파일 에서 복원할 때 데이터를 복원 할 mongorestore --collection 대상 컬렉션 의 이름을 지정합니다. mongorestore 를 지정하지 않으면 는 입력 파일 이름에서 컬렉션 이름을 가져옵니다. 입력 파일 확장자가 있는 경우 MongoDB 컬렉션 이름에서 파일 확장자를 생략합니다.

mongorestore --db=reporting --collection=employeesalaries dump/test/salaries.bson

--compressors=<string>

mongodump가 mongorestore 클라이언트와 MongoDB 서버 간의 네트워크 통신에 사용하는 압축 알고리즘을 지정합니다. --compressors 옵션에 대해 다음 값 중 하나 이상을 사용할 수 있습니다.

• snappy

• zlib

• zstd

여러 압축 알고리즘을 지정하는 경우 mongorestore 는 MongoDB deployment 에서 지원하는 목록에서 첫 번째 압축 알고리즘을 사용합니다.

압축기에 대한 자세한 내용은 고 (Go) 운전자 네트워크 압축 문서를 참조하세요.

--config=<filename>

버전 100 의 새로운 기능입니다.3.0.

다음 mongorestore 옵션에 대한 민감한 값을 포함하는 YAML 설정 파일의 전체 경로를 지정합니다.

• --password

• --uri

• --sslPEMKeyPassword

비밀번호 프롬프트를 통해 비밀번호를 지정하는 것 외에 mongorestore에 비밀번호를 지정하는 권장 방법입니다. 파일 내의 인수를 어떤 조합으로든 사용할 수 있습니다.

구성 파일은 다음과 같은 형식을 취합니다:

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

password 옵션을 지정하고 uri를 지정하지 않으면, --username 및 --host와 같은 mongorestore 명령줄 옵션을 사용하여 연결 문자열의 다른 구성 요소를 지정할 수 있습니다.

적절한 파일 시스템 권한으로 이 파일을 보호해야 합니다.

중요

--config 옵션을 사용할 때는 다음과 같은 제한 사항 및 동작을 염두에 두세요.

• password 필드를 제공하고 uri 필드에 충돌하는 비밀번호가 포함된 연결 문자열을 제공하면 mongorestore에서 오류가 발생합니다.

• --config 를 사용하여 설정 파일 지정하고 --password, --uri 또는 --sslPEMKeyPassword mongorestore 명령줄 옵션을 사용하는 경우 명령줄 옵션이 해당 설정 파일 옵션을 재정의합니다.

--convertLegacyIndexes

버전 100 의 새로운 기능입니다.0.0.

해당 mongodump 출력에 지정된 유효하지 않은 인덱스 옵션을 모두 제거하고 기존 인덱스 키 값을 유효한 값을 사용하도록 다시 작성합니다.

• 유효하지 않은 인덱스 옵션은 명령에 유효한 필드 createIndexes 로 나열되지 않은 인덱스 에 지정된 모든 옵션입니다. name collation custom_field 예시 를 들어 및 는 유효하지만 임의의 는 유효하지 않습니다. 를 --convertLegacyIndexes 지정하면 유효하지 않은 인덱스 옵션이 발견되면 삭제됩니다.

• 레거시 인덱스 키 값은 더 이상 지원되지 않는 인덱스 유형에 대한 모든 값입니다. 예시 를1 들어 및 -1 는 유효한 인덱스 키 값이지만 0 또는 빈 문자열은 레거시 값입니다. 를 --convertLegacyIndexes 지정하면 발견된 모든 레거시 인덱스 키 값이 로 다시 1 작성됩니다. 비어 있지 않은 문자열 값은 대체되지 않습니다.

--convertLegacyIndexes 옵션을 지정하지 않으면 잘못된 인덱스 옵션 또는 레거시 인덱스 키 값이 있을 때 인덱스 빌드가 실패할 수 있습니다.

옵션이 --noIndexRestore 에 지정된 경우 mongorestore --convertLegacyIndexes 옵션은 무시됩니다.

--db=<database>, -d=<database>

중요

디렉토리 또는 아카이브 파일 에서 복원할 때 --db 및 옵션 사용은 더 이상 사용되지 않습니다. 아카이브 또는 --collection --nsInclude 디렉토리 에서 특정 데이터베이스 또는 컬렉션 복원 하려면 를 참조하세요.

BSON 파일에서 복원하는 경우, mongorestore가 데이터를 복원할 대상 데이터베이스를 지정합니다. 데이터베이스가 존재하지 않으면 mongorestore가 데이터베이스를 만듭니다. 예를 들어 다음 예에서는 salaries 컬렉션을 reporting 데이터베이스로 복원합니다.

mongorestore --db=reporting dump/test/salaries.bson

를 지정하지 않으면 가 데이터 파일에서 데이터베이스 이름을 --db 읽습니다. mongorestore

또는 URI connection string에 직접 데이터베이스를 지정할 수도 있습니다. 연결 문자열을 제공하면서 --db을 사용하고 상충하는 정보를 지정하면 오류가 발생합니다.

--dir=string

덤프 디렉토리를 지정합니다.

• --dir 옵션과 덤프 디렉토리도 지정하는 <path> 인수를 모두 mongorestore에 지정할 수는 없습니다.

• --archive 옵션은 --dir 옵션과 함께 사용할 수 없습니다.

--drop

덤프된 백업 에서 컬렉션을 복원하기 전에 대상 데이터베이스 에서 컬렉션을 삭제합니다. --drop 는 백업 에 없는 컬렉션을 삭제하지 않습니다.

복원 admin 데이터베이스 포함된 경우 와mongorestore 함께 authorization 는 --drop 모든 사용자 자격 증명 제거하고 덤프 파일 에 정의된 사용자로 대체합니다. 따라서 이 활성화된 시스템에서 는mongorestore 기존 사용자 및 덤프 파일 에 정의된 사용자에 대해 인증할 수 있어야 합니다. 가 mongorestore 덤프 파일 에 정의된 사용자를 인증할 수 없는 경우 복원 프로세스 실패하고 빈 데이터베이스 남게 됩니다.

복원의 일부로 컬렉션을 제거하고 다시 만드는 경우, --drop을 --preserveUUID와 함께 사용하지 않는 한 새로 만든 컬렉션은 다른 UUID를 갖습니다.

--dryRun

실제로 데이터를 가져오지 않고 mongorestore를 실행하여 mongorestore 요약 정보를 반환합니다. --verbose와 함께 사용하면 더 자세한 요약 정보를 생성할 수 있습니다.

--fixDottedHashIndex

점 필드의 모든 해시 인덱스를 대상 데이터베이스에 단일 필드 오름차순 인덱스로 생성합니다.

--gssapiHostName=<hostname>

GSSAPI/Kerberos를 사용하여 서비스의 호스트 이름을 지정합니다. 시스템의 호스트 이름이 DNS에서 확인한 호스트 이름과 일치하지 않는 경우에만 필요합니다.

이 옵션은 MongoDB Enterprise에서만 사용할 수 있습니다.

--gssapiServiceName=<serviceName>

GSSAPI/ Kerberos 사용하여 서비스 이름을 지정합니다. 서비스가 기본값 이름인 mongodb 를 사용하지 않는 경우에만 필요합니다.

이 옵션은 MongoDB Enterprise에서만 사용할 수 있습니다.

--gzip

mongodump --gzip에서 생성된 데이터 스트림 또는 압축 파일에서 복원합니다.

압축 파일이 포함된 덤프 디렉토리에서 복원하려면 --gzip 옵션과 함께 mongorestore를 실행하세요.

압축된 아카이브 파일에서 복원하려면 --gzip 및 --archive 옵션을 모두 사용하여 mongorestore를 실행합니다.

참고

--nsFrom 및 --nsTo 옵션을 옵션과 함께 사용하여 --gzip 복원하려는 컬렉션 의 네임스페이스 를 변경할 수 있습니다.

--help

옵션 및 mongorestore의 사용에 대한 정보를 반환합니다.

--host=<hostname><:port>, -h=<hostname><:port>

기본값: localhost:27017

MongoDB deployment의 확인 가능한 호스트 이름을 지정합니다. 기본적으로 mongorestore는 포트 번호 27017의 로컬 호스트에서 실행되는 MongoDB 인스턴스에 연결을 시도합니다.

복제본 세트 에 연결하려면 replSetName 다음과 같이 및 설정하다 멤버의 시드 목록 지정합니다.

--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

복제본 설정 목록 형식을 지정할 때 mongorestore는 항상 프라이머리에 연결합니다.

또한 해당 멤버의 호스트와 포트만 지정하여 복제본 세트의 단일 멤버에 연결할 수 있습니다.

--host=<hostname1><:port>

IPv6을 사용하고 <address>:<port> 형식을 사용하는 경우 주소 및 포트 조합의 일부를 대괄호로 묶어야 합니다 (예: [<address>]).

또는 URI connection string에 호스트 이름을 직접 지정할 수도 있습니다. --host를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

--keepIndexVersion

복원 프로세스 중에 mongorestore가 인덱스를 최신 버전으로 업그레이드하는 것을 방지합니다.

--maintainInsertionOrder

기본값: false

이를 지정하면 mongorestore는 입력 소스에 표시된 순서대로 문서를 삽입합니다. 즉, 일괄 쓰기 배치 순서와 배치 내 문서 순서가 모두 유지됩니다.

--maintainInsertionOrder --stopOnError를 numInsertionWorkersPerCollection 지정하면 도 1 활성화되고 가 로 설정됩니다.

지정하지 않으면 mongorestore가 임의의 순서로 삽입을 수행할 수 있습니다.

--noIndexRestore

mongorestore가 해당 mongodump 출력에 지정된 대로 인덱스를 복원 및 빌드하지 못하도록 합니다.

--noOptionsRestore

mongorestore이(가) 복원된 컬렉션에서 데이터베이스 명령 으로 지정된 것과 collMod 같은 컬렉션 옵션을 설정하지 못하도록 합니다.

--nsExclude=<namespace pattern>

복원 에서 일치하는 네임스페이스를 제외할 네임스페이스"test.myCollection" "reporting.*"패턴(예:,,)을"dept*.bar" 지정합니다. 패턴 에서는 별표 를 와일드카드로 사용할 수 * 있습니다. 와일드카드 패턴 의 예시 는 와일드카드를 사용하여 컬렉션 복원을 참조하세요.

를 여러 번 지정하여 여러 네임스페이스 패턴을 제외할 수 있습니다.--nsExclude

--nsExclude 및 --nsInclude를 모두 지정하는 경우 --nsExclude 에서 지정한 패턴 이 우선합니다. 예시 들어 --nsExclude="prod.*" 및 --nsInclude="prod.trips"를 모두 지정하면 prod 네임스페이스 의 컬렉션이 복원되지 않습니다.

--nsFrom=<namespace pattern>

--nsTo와 함께 사용하면 복원 작업 중에 네임스페이스의 이름을 바꿀 수 있습니다. --nsFrom은 덤프 파일의 컬렉션을 지정하고 --nsTo는 복원된 데이터베이스에서 사용해야 하는 이름을 지정합니다.

--nsFrom는 네임스페이스 패턴 인수로 받습니다. 네임스페이스 패턴--nsFrom가 지정된 패턴 과 일치하는 모든 네임스페이스 참조할 수 있도록 허용합니다. mongorestore는 네임스페이스 패턴 의 가장 작은 유효한 항목과 일치합니다.

간단하게 대체하려면 별표(*)를 와일드 카드로 사용합니다. 백슬래시를 사용하여 별표와 백슬래시를 모두 이스케이프 처리하세요. 대체 항목은 일치 항목에 선형적으로 대응합니다. --nsFrom의 각 별표는 --nsTo의 별표와 일치해야 하고, --nsFrom의 첫 번째 별표는 nsTo의 첫 번째 별표와 일치해야 합니다.

더 복잡한 대체의 경우 달러 기호를 사용하여 대체에 사용할 '와일드카드' 변수를 구분합니다. 복원 중 컬렉션 네임스페이스 변경 은 달러 기호로 구분된 와일드카드를 사용한 복잡한 대체의 예를 제공합니다.

별표가 있는 대체와 달리 달러 기호로 구분된 와일드카드가 있는 대체는 선형일 필요가 없습니다 .

--nsInclude=<namespace pattern>

패턴 과 일치하는 네임스페이스만 복원 하도록 네임스페이스 패턴"test.myCollection" "reporting.*"(예:,,)을"dept*.bar" 지정합니다. 패턴 에서는 별표 를 와일드카드로 사용할 수 * 있습니다. 와일드카드 패턴 의 예시 는 와일드카드를 사용하여 컬렉션 복원을 참조하세요.

를 여러 번 지정하여 여러 네임스페이스 패턴을 포함할 수 있습니다.--nsInclude

소스 디렉터리나 파일(즉, 데이터를 복원하고자 하는 디렉토리/파일)에 네임스페이스 패턴과 일치하는 데이터 파일이 없는 경우 데이터가 복원되지 않습니다.

ASCII가 아닌 문자가 포함된 컬렉션 이름의 경우 mongodump는 해당 파일 이름을 퍼센트 인코딩된 이름으로 출력합니다. 그러나 이러한 컬렉션을 복원할 때는 인코딩된 이름을 사용하지 마세요. 대신 ASCII가 아닌 문자가 포함된 네임스페이스를 사용하세요.

예를 들어 덤프 디렉토리에 dump/test/caf%C3%A9s.bson이 포함되어 있으면 --nsInclude "test.cafés"을 지정합니다.

--nsExclude 및 --nsInclude를 모두 지정하는 경우 --nsExclude 에서 지정한 패턴 이 우선합니다. 예시 들어 --nsExclude="prod.*" 및 --nsInclude="prod.trips"를 모두 지정하면 prod 네임스페이스 의 컬렉션이 복원되지 않습니다.

--nsTo=<namespace pattern>

--nsFrom과 함께 사용하면 복원 작업 중에 네임스페이스의 이름을 바꿀 수 있습니다. --nsTo는 복원된 데이터베이스에서 사용할 새 컬렉션 이름을 지정하고 --nsFrom은 덤프 파일에서 사용할 이름을 지정합니다.

--nsTo는 네임스페이스 패턴 인수로 받습니다. 네임스페이스 패턴--nsTo가 지정된 패턴 과 일치하는 모든 네임스페이스 참조할 수 있도록 허용합니다. mongorestore는 네임스페이스 패턴 의 가장 작은 유효한 항목과 일치합니다.

간단하게 대체하려면 별표(*)를 와일드 카드로 사용합니다. 백슬래시를 사용하여 별표와 백슬래시를 모두 이스케이프 처리하세요. 대체 항목은 일치 항목에 선형적으로 대응합니다. --nsFrom의 각 별표는 --nsTo의 별표와 일치해야 하고, --nsFrom의 첫 번째 별표는 nsTo의 첫 번째 별표와 일치해야 합니다.

더 복잡한 대체의 경우 달러 기호를 사용하여 대체에 사용할 '와일드카드' 변수를 구분합니다. 복원 중 컬렉션 네임스페이스 변경 은 달러 기호로 구분된 와일드카드를 사용한 복잡한 대체의 예를 제공합니다.

별표가 있는 대체와 달리 달러 기호로 구분된 와일드카드가 있는 대체는 선형일 필요가 없습니다 .

--numInsertionWorkersPerCollection=<int>

기본값: 1

컬렉션당 동시에 실행할 삽입 작업자 수를 지정합니다.

대규모 가져오기의 경우 삽입 작업자 수를 늘리면 가져오기 속도가 빨라질 수 있습니다.

--numParallelCollections=<int>, -j=<int>

기본값: 4

mongorestore 컬렉션의 수는 병렬로 복원해야 합니다.

단일 -j 컬렉션 복원할-j --numInsertionWorkersPerCollection --numParallelCollections때 를 지정하면 이(가) 이(가) 아닌 옵션에 매핑됩니다.

--objcheck

버전 9.0부터 더 이상 사용되지 않습니다.

mongorestore 클라이언트의 모든 요청 수신 시 가 유효성을 검사하도록 강제하여 클라이언트가 데이터베이스 에 유효하지 않은 문서를 삽입하지 않도록 합니다. 하위 문서 중첩이 많은 객체의 경우 이 성능에 약간 영향 미칠 수--objcheck 있습니다.

MongoDB 9.0부터 이 옵션은 서버 동작에 영향을 미치지 않습니다. 서버는 항상 BSON 문서를 유효성 검사합니다.

--oplogFile=<path>

복원을 위한 oplog 데이터가 포함된 oplog 파일의 경로를 지정합니다. --oplogReplay와(과) 함께 사용하세요.

--oplogFile oplog.bson를 지정하고 덤프 디렉토리 의 최상위 수준에 파일 이 있는mongorestore 경우 는 오류를 반환합니다.

경고

oplogFile 사용 시 주의하세요. 적용할 oplog 항목을 수동으로 지정하면 복원된 데이터가 손상되거나 불일치가 발생할 수 있습니다.

--oplogLimit=<timestamp>

이(가) 타임스탬프가 이상인 mongorestore oplog 항목을 적용하지 못하도록 <timestamp> 합니다. 형식으로 <timestamp> 값을 지정합니다.<time_t>:<ordinal> 여기서 <time_t> 은 유닉스 시간 이후의 초이고,<ordinal> 은 지정된 초 동안 발생한 oplog 의 연산 카운터를 나타냅니다.

경고

oplogLimit 사용 시 주의하세요. 적용할 oplog 항목을 수동으로 지정하면 복원된 데이터가 손상되거나 불일치가 발생할 수 있습니다.

--oplogLimit 반드시 를 --oplogReplay 옵션과 함께 사용해야 합니다.

--oplogReplay

데이터베이스 덤프를 복원한 후 oplog.bson 파일 에서 oplog 항목을 재생합니다.

참고

샤드 클러스터는 oplogReplay 옵션을 지원 하지 않습니다.

복원 시 oplog.bson 파일의 oplog 항목을 적용하려면 mongorestore --oplogReplay를 사용하세요. mongodump --oplog를 mongorestore --oplogReplay와 함께 사용하여 데이터가 최신이고 덤프 작업 중에 발생한 모든 쓰기가 있는지 확인할 수 있습니다.

mongorestore 다음 위치에서 BSON 파일의 유효한 소스를 검색합니다:

• 덤프 디렉토리의 최상위 수준으로, mongodump --oplog로 작성된 덤프의 경우와 같습니다.

• --oplogFile(으)로 지정된 경로입니다.

• <dump-directory>/local/oplog.rs.bson복제본 세트 의 oplog.rs 멤버인 의 local 데이터베이스 에 있는 컬렉션 의 덤프의 경우.mongod

덤프 디렉토리 의 최상위 수준에 파일 있고 로 지정된 경로가 있는 --oplogFile 경우 oplog.bson mongorestore 는 오류를 반환합니다.

덤프 디렉토리의 최상위 레벨에 oplog.bson 파일이 있는 경우 mongorestore는 해당 파일을 oplog로 복원합니다. dump/local 디렉토리에 bson 파일도 있는 경우 일반 컬렉션과 같이 mongorestore가 해당 파일을 복원합니다.

를 --oplogFile 사용하여 oplog 파일 지정하면mongorestore 는 해당 파일 oplog 로 복원합니다.dump/local 디렉토리 에 bson 파일도 있는 경우 는mongorestore 일반 컬렉션과 같이 해당 파일을 복원합니다.

oplog 재생 출력의 다음 메시지는 oplog 재생 전의 삽입 수를 보여줍니다. 재생 중에 수행되는 삽입은 포함되지 않습니다.

0 document(s) restored successfully. 0 document(s) failed to
restore.

의 예시 는 Oplog 파일을 --oplogReplay사용하여 데이터 복원을 참조하세요.

참고

mongorestore를--oplogReplay와 함께 사용하여 복제본 세트 복원 경우mongodump --oplog를 사용하여 생성된 복제본 세트 멤버의 전체 덤프를 복원 해야 합니다. 다음 옵션 중 하나를 사용하여 복원할 데이터를 제한하는 경우--oplogReplay을 사용한 mongorestore의 실행이 실패합니다.

• --db

• --collection

• --nsInclude

• --nsExclude

• --nsFrom

• --nsTo

경고

mongorestore Time Series 형식 변환에 걸친 oplog 범위를 재생할 수 없습니다. 서버는 MongoDB 8.x와 MongoDB 9.0 사이의 기능 호환성 버전(기능 호환성 버전)을 변경할 때 이 변환을 수행합니다. 변환 전체에 걸쳐 복원하는 방법을 학습하려면 Time Series 형식 변환에 걸친 oplog 재생을 참조하십시오.

팁

• mongorestore 필수 액세스

• mongodump --oplog

--password=<password>, -p=<password>

인증 사용하는 MongoDB database 에 인증하는 데 사용할 비밀번호를 --username 지정합니다. 및 옵션과 함께 사용합니다.--authenticationDatabase

사용자에게 비밀번호를 입력하라는 메시지를 표시하려면 없이 --username 옵션을 전달하거나 에서와 --password --password --password="" 같이 빈 문자열을 값으로 지정합니다.

또는 URI connection string에 비밀번호를 직접 지정할 수도 있습니다. --password를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

를 사용하여 MongoDB Atlas cluster 에 연결하는 MONGODB-AWS authentication mechanism 경우 다음에서 AWS 시크릿 액세스 키를 지정할 수 있습니다.

• 이 필드,

• 또는 connection string

• AWS_SECRET_ACCESS_KEY 환경 변수.

각각의 예는 AWS IAM 자격 증명을 사용하여 MongoDB Atlas Cluster에 연결하기를 참조하세요.

경고

일부 시스템에서는 --password 옵션을 사용해 직접 제공된 비밀번호가 다른 사용자가 호출할 수 있는 ps와 같은 시스템 상태 프로그램에 표시될 수 있습니다. 대신 다음을 고려해 보세요.

• --password 옵션을 생략하여 대화형 비밀번호 프롬프트를 받거나

• --config 옵션을 사용하여 비밀번호가 포함된 설정 파일을 지정합니다.

<path>

데이터를 복원할 디렉터리 경로 또는 BSON 파일 이름입니다.

<path> 인수와 덤프 디렉토리도 지정하는 --dir 옵션을 모두 mongorestore에 지정할 수는 없습니다.

--port=<port>

기본값: 27017

MongoDB 인스턴스가 클라이언트 연결 수신을 대기하는 TCP 포트를 지정합니다.

또는 URI connection string에 직접 포트를 지정할 수도 있습니다. --port 를 사용하면서 연결 문자열 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

--preserveUUID

복원된 컬렉션은 복원의 일부로 제거되고 다시 생성되는 컬렉션에 대해 새 UUID를 만드는 대신 복원 데이터의 UUID를 사용합니다.

를 사용하려면 --preserveUUID --drop 옵션도 포함해야 합니다.

참고

샤드 클러스터는 preserveUUID 옵션을 지원 하지 않습니다.

--quiet

출력량을 제한하려고 시도하는 자동 모드에서 mongorestore를 실행합니다.

이 옵션은 다음과 같은 활동을 억제합니다.

• errors

• 데이터베이스 명령의 출력

• 복제 활동

• 연결 수락 이벤트

• 연결 종료 이벤트

--restoreDbUsersAndRoles

지정된 데이터베이스에 대한 사용자 및 역할 정의를 복원합니다. 자세한 내용은 system.roles 컬렉션 및 system.users 컬렉션을을 참조하세요.

참고

• --restoreDbUsersAndRoles 는 --dumpDbUsersAndRoles 옵션으로 생성된 데이터베이스 덤프에서만 사용할 수 있습니다.

• 을(를) 지정하여 admin --db admin 데이터베이스 복원하면 모든 사용자와 역할이 자동으로 복원됩니다. 데이터베이스 --restoreDbUsersAndRoles 에서는 를 사용할 수 admin 없으며, 이를 시도하면 오류가 발생합니다.

--ssl

TLS/SSL 지원 mongod 활성화된 또는 에 대한 연결을 활성화합니다.mongos

또는 URI connection string에서 직접 TLS/SSL 지원을 구성할 수도 있습니다. 연결 문자열을 제공하면서 --ssl을 사용하고 상충하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslAllowInvalidCertificates

서버 인증서에 대한 유효성 검사 검사를 우회하고 유효하지 않은 인증서의 사용을 허용합니다. 설정을 사용할 allowInvalidCertificates 때 MongoDB 유효하지 않은 인증서 사용에 대한 경고를 기록합니다.

경고

--sslAllowInvalidCertificates 옵션은 사용할 수 있는 경우에도 가급적 사용하지 않는 것이 좋습니다. --sslAllowInvalidCertificates를 사용해야만 하는 경우, 침입이 불가능한 시스템에서만 옵션을 사용하세요.

서버 인증서의 유효성을 mongod 검사하지 않고 또는 인스턴스 에 연결하면 잠재적인 보안 위험이 발생할 수 있습니다. TLS/SSL 인증서에서 호스트 이름 유효성 검사 검사만 비활성화해야 하는 경우 를 mongos --sslAllowInvalidHostnames 참조하세요.

또는 URI connection string에서 직접 인증서 유효성 검사 비활성화할 수도 있습니다. --sslAllowInvalidCertificates 를 사용하면서 연결 문자열 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslAllowInvalidHostnames

TLS/SSL 인증서의 호스트 이름 유효성 검사를 비활성화합니다. 인증서의 호스트 이름이 지정된 호스트 이름과 일치하지 않더라도 mongorestore가 MongoDB 인스턴스에 연결할 수 있도록 허용합니다.

또는 URI connection string에서 호스트 이름 유효성 검사를 비활성화할 수도 있습니다. --sslAllowInvalidHostnames를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslCAFile=<filename>

인증 기관의 루트 인증서 체인이 포함된 .pem 파일을 지정합니다. 상대 경로 또는 절대 경로를 사용하여 .pem 파일의 이름을 지정합니다.

또는 URI connection string에 직접 .pem 파일을 지정할 수도 있습니다. --sslCAFile를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslCRLFile=<filename>

인증서 해지 목록이 포함된 .pem 파일을 지정합니다. 상대 경로 또는 절대 경로를 .pem 파일의 이름을 지정합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslPEMKeyFile=<filename>

TLS/SSL 인증서와 키가 모두 포함되어 있는 .pem 파일을 지정합니다. 상대 경로 또는 절대 경로를 사용해 .pem 파일의 이름을 지정합니다.

이 옵션은--ssl옵션을 사용하여allowConnectionsWithoutCertificates 없이CAFile가 활성화된mongod또는mongos에 연결할 때 필요합니다.

또는 URI connection string에 직접 .pem 파일을 지정할 수도 있습니다. --sslPEMKeyFile를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

--sslPEMKeyPassword=<value>

인증서 키 파일 (예: )을 해독하기 위한 비밀번호를--sslPEMKeyFile 지정합니다. 인증서 키 파일 암호화됨 --sslPEMKeyPassword mongorestore 경우에만 옵션을 사용합니다. 모든 경우에 는 모든 로깅 및 보고 출력에서 비밀번호를 삭제합니다.

PEM 파일 의 개인 키가 암호화됨 있고 옵션을 지정하지 않으면 에서 암호를 입력하라는 --sslPEMKeyPassword mongorestore 메시지가 표시됩니다.TLS/SSL 인증서 암호를 참조하세요.

또는 URI connection string에 비밀번호를 직접 지정할 수도 있습니다. --sslPEMKeyPassword를 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

TLS/SSL 및 MongoDB에 대한 자세한 내용은 TLS/SSL을 위한 mongod 및 mongos 구성 및 클라이언트를 위한 TLS/SSL 구성을 참조하세요.

경고

일부 시스템에서는 --sslPEMKeyPassword 옵션을 사용해 직접 제공된 비밀번호가 다른 사용자가 호출할 수 있는 ps와 같은 시스템 상태 프로그램에 표시될 수 있습니다. 대신 --config 옵션을 사용하여 비밀번호가 포함된 설정 파일을 지정하는 것이 좋습니다.

--stopOnError

오류가 발생하면 mongorestore에서 복원을 강제로 중지합니다.

기본값 으로 는mongorestore 중복 키 및 문서 유효성 검사 오류가 발생해도 계속 진행됩니다. 이러한 오류가 발생하면 프로그램이 중지되도록 하려면 을 --stopOnError 지정합니다.

--uri=<connectionString>

따옴표로 묶인 MongoDB 배포의 확인 가능한 URI 연결 문자열을 지정합니다.

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

의 버전부터 100.0 mongorestore옵션을 --uri 사용하지 않고 연결 문자열 위치 매개변수로 대신 제공할 수 있습니다.

mongorestore mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

연결 문자열은 mongodb:// 또는 mongodb+srv:// 중 하나로 시작하기만 하면 명령줄의 어느 지점에서나 위치 매개변수로 지정할 수 있습니다. 예시:

mongorestore --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

연결 문자열은 하나만 제공할 수 있습니다. --uri 옵션을 사용하든 위치 인수로 사용하든 둘 이상을 포함하려고 하면 오류가 발생합니다.

연결 문자열의 구성 요소에 대한 자세한 내용은 연결 문자열 URI 형식 문서를 참조하세요.

참고

connection string의 일부 구성요소는 --username 및 --password와 같은 자체 명시적 명령줄 옵션을 사용하여 지정할 수도 있습니다. 명시적 옵션을 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

참고

Ubuntu 에서 를 사용하는 mongorestore 18.04 경우 cannot unmarshal DNS 옵션과 함께 SRV 연결 문자열(mongodb+srv:// 형식)을 사용할 때 --uri 오류 메시지가 표시될 수 있습니다. 이 경우 다음 옵션 중 하나를 대신 사용합니다.

• 비SRV 연결 문자열 --uri 있는 옵션(mongodb:// 형식)

• --host 옵션을 사용하여 직접 연결할 호스트를 지정하세요.

경고

일부 시스템에서는 --uri 옵션으로 연결 문자열에 제공된 비밀번호가 다른 사용자가 호출할 수 있는 ps 와 같은 시스템 상태 프로그램에 표시될 수 있습니다. 대신 다음을 고려하세요.

• 대화형 암호 프롬프트를 받기 위해 연결 문자열에서 암호를 생략하거나

• --config 옵션을 사용하여 비밀번호가 포함된 설정 파일을 지정합니다.

--username=<username>, -u=<username>

인증 사용하는 MongoDB database 에 인증할 사용자 이름 --password 지정합니다. 및 옵션과 함께 사용합니다.--authenticationDatabase

또는 URI connection string에 직접 사용자 이름을 지정할 수도 있습니다. --username을 사용하면서 연결 문자열을 제공하고 충돌하는 정보를 지정하면 오류가 발생합니다.

를 사용하여 MongoDB Atlas cluster 에 연결하는 MONGODB-AWS authentication mechanism 경우 다음에서 AWS 액세스 키 ID 지정할 수 있습니다.

• 이 필드,

• 또는 connection string

• AWS_ACCESS_KEY_ID 환경 변수.

각각의 예는 AWS IAM 자격 증명을 사용하여 MongoDB Atlas Cluster에 연결하기를 참조하세요.

--verbose, -v

표준 출력이나 로그 파일에 반환되는 내부 보고의 양이 늘어납니다. 옵션을 여러 번 포함하여 -v 형식의 상세도를 높입니다(예: -vvvvv.)

--version

mongorestore 출시 번호를 반환합니다.

--writeConcern=<document>

기본값: 대다수(majority)

가 수행하는 각 쓰기 (write) 작업에 대한 쓰기 고려 (write concern) 지정합니다.mongorestore

w 옵션을 사용하여 쓰기 고려를 문서로 지정합니다.

--writeConcern="{w:'majority'}"

쓰기 고려도 --uri connection string에 포함되어 있는 경우 명령줄 --writeConcern이 URI 문자열에 지정된 쓰기 고려를 재정의합니다.

자세히 알아보기

• mongorestore 호환성 및 설치

• 행동

• mongorestore 예제

• 데이터베이스 덤프를 사용하여 자체 관리형 샤딩된 클러스터 백업